home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / os2 / e33min.zip / emacs / 19.33 / etc / DOC
Text File  |  1996-08-18  |  779KB  |  14,967 lines

  1. Femx-original-file-name
  2. Return the original file name for FILENAME, with case mapping undone.
  3. Just return FILENAME if `preserve-file-name-case' is nil.
  4. This function uses the text properties set by `expand-file-name' if
  5. `preserve-file-name-case' is non-nil.
  6.  
  7. (emx-original-file-name FILENAME)Femx-binary-mode-p
  8. Return t if binary mode should be used for FILENAME.
  9. Otherwise, return nil.
  10. Binary mode is used if one of the regular expressions in
  11. `emx-binary-mode-list' match FILENAME.
  12.  
  13. (emx-binary-mode-p FILENAME)Fpm-session-bond
  14. Establish or break bond between emacs.exe and pmemacs.exe sessions.
  15. Non-nil BOND establishes the bond, nil BOND breaks the bond.
  16.  
  17. (pm-session-bond BOND)Fremove-from-window-list
  18. Remove Emacs from the Window List.
  19.  
  20. (remove-from-window-list)Ffilesystem-type
  21. Return a string identifying the filesystem type of PATH.
  22. Filesystem types include FAT, HPFS, LAN, CDFS, NFS and NETWARE.
  23.  
  24. (filesystem-type STRING)Ffile-name-valid-p
  25. Return t if STRING is a valid file name.
  26. Whether a file name is valid or not depends on the file system.
  27. This is a special feature of GNU Emacs for emx.
  28.  
  29. (file-name-valid-p STRING)Fkeyboard-type
  30. Return information about the keyboard.
  31. The value is a list of the form (COUNTRY SUBCOUNTRY CODEPAGE), where
  32.   COUNTRY is the country code of the keyboard layout (a string),
  33.     for instance "US".
  34.   SUBCOUNTRY is the subcountry code (a string), for instance "103 ".
  35.   CODEPAGE is the codepage (a number), on which the current keyboard
  36.     translation table is based, for instance 437.
  37. This function is currently implemented under OS/2 only.
  38. If the keyboard information cannot be retrieved (because Emacs is
  39. running under MS-DOS, for instance), nil is returned.
  40.  
  41. (keyboard-type)Femacs-priority
  42. Set the priority of the Emacs process.
  43. PCLASS selects the priority class.  Possible values are
  44.   nil (no change),
  45.   idle-time (idle-time priority class -- you don't want to use this),
  46.   regular (regular priority class -- this is the OS/2 default,
  47.     a priority boost is applied if the process is in the foreground), and
  48.   foreground-server (fixed-high priority class -- use with care).
  49. PLEVEL is nil (same as 0) or a number between 0 and 31 which indicates
  50.   the priority level within the priority class.  Level 31 has the highest
  51.   priority in each class, the default value assigned by OS/2 is 0.
  52. Child processes inherit the priority unless process-priority is non-nil.
  53. This function is implemented under OS/2 only.
  54.  
  55. (emacs-priority PCLASS &optional PLEVEL)Fcurrent-code-page
  56. Return the current code page identifier.
  57. The value is nil if the code page identifier cannot be retrieved.
  58. Code pages are not yet supported under MS-DOS.
  59.  
  60. (current-code-page)Flist-code-pages
  61. Return a list of available code pages.
  62. Code pages are not yet supported under MS-DOS.
  63.  
  64. (list-code-pages)Fset-code-page
  65. Set the code page to CODE-PAGE.
  66. Code pages are not yet supported under MS-DOS.
  67.  
  68. (set-code-page CODE-PAGE)Fset-cursor-size
  69. Set the text-mode cursor size.
  70. The cursor will occupy rows START through END.  Negative arguments
  71. are percentages.
  72.  
  73. (set-cursor-size START END)Fget-cursor-size
  74. Return the text-mode cursor size: (START . END).
  75. START is the start row, END is the end row of the cursor.
  76. Return nil if the cursor size cannot be retrieved.
  77.  
  78. (get-cursor-size)Fget-ea
  79. Get from file or directory PATH the extended attribute NAME.
  80. Return nil if there is no such extended attribute.  Otherwise,
  81. return a vector [FLAGS TYPE SIZE VALUE], where FLAGS is the flags byte
  82. of the extended attribute, TYPE identifies the type of the extended
  83. attribute (`ascii', `binary', `bitmap', `metafile', `icon', `ea',
  84. `mvmt', `mvst', `asn1', or a number), SIZE is the contents of the
  85. size field of the value and VALUE is the (binary) value
  86. of the extended attribute, including the type and size fields.
  87. TYPE and SIZE are nil if the value is too short.
  88.  
  89. (get-ea PATH NAME)Fget-ea-string
  90. Get from file or directory PATH the extended attribute NAME.
  91. Return nil if there is no such extended attribute, or if the value
  92. of the extended attribute is not a string.
  93.  
  94. (get-ea-string PATH NAME)Fget-ea-list
  95. Get from file or directory PATH all extended attributes.
  96. Return a list of elements (NAME . VECTOR), one element for each
  97. extended attribute.  NAME is the name of the extended attribute,
  98. VECTOR is a vector [FLAGS TYPE SIZE VALUE], where FLAGS is the flags
  99. byte of the extended attribute, TYPE identifies the type of the extended
  100. attribute (`ascii', `binary', `bitmap', `metafile', `icon', `ea',
  101. `mvmt', `mvst', `asn1', or a number), SIZE is the contents of the
  102. size field of the value and VALUE is the (binary) value
  103. of the extended attribute, including the type and size fields.
  104. TYPE and SIZE are nil if the value is too short.
  105.  
  106. (get-ea-list PATH)Fput-ea
  107. Attach an extended attribute to the file or directory PATH.
  108. NAME is the name of the extended attribute.  DATA is a vector
  109. [FLAGS TYPE SIZE VALUE] containing the value, where FLAGS is the
  110. flags byte of the extended attribute, TYPE identifies the type of
  111. the extended attribute (`ascii', `binary', `bitmap', `metafile',
  112. `icon', `ea', `mvmt', `mvst', `asn1', or a number), SIZE is the
  113. size the value and VALUE is the (binary) value of the extended
  114. attribute, including the type and size fields.  If TYPE is non-nil,
  115. it will override the type field of VALUE.  If SIZE is non-nil, it
  116. will override the size field of VALUE.
  117.  
  118. (put-ea PATH NAME VALUE)Fput-ea-list
  119. Attach a list of extended attributes to the file or directory PATH.
  120. EAS is a list of elements (NAME . VECTOR), one element for each
  121. extended attribute.  NAME is the name of the extended attribute,
  122. VECTOR is a vector [FLAGS TYPE SIZE VALUE], where FLAGS is the flags
  123. byte of the extended attribute, TYPE identifies the type of the extended
  124. attribute (`ascii', `binary', `bitmap', `metafile', `icon', `ea', `mvmt',
  125. `mvst', `asn1', or a number), SIZE is the size the value and VALUE is
  126. the (binary) value of the extended attribute, including the type and size
  127. fields.  If TYPE is non-nil, it will override the type field of VALUE.
  128. If SIZE is non-nil, it will override the size field of VALUE.
  129. If the optional third argument REPLACE is non-nil, the existing extended
  130. attributes of the file or directory are removed before attaching the
  131. new extended attributes.
  132. If the optional fourth argument FIXLONGNAME is non-nil, the .LONGNAME
  133. extended attribute will be removed if it doesn't match the file name.
  134.  
  135. (put-ea-list PATH EAS &optional REPLACE FIXLONGNAME)Fput-ea-string
  136. Attach an extended attribute (string) to the file or directory PATH.
  137. NAME is the name of the extended attribute.  VALUE is a string
  138. containing the value.  The flags byte of the extended attribute is
  139. set to 0, the type is set to `ascii', and the size is computed from
  140. the length of the string.
  141.  
  142. (put-ea-string PATH NAME VALUE)Fremove-ea
  143. Remove extended attribute NAME from the file or directory PATH.
  144.  
  145. (remove-ea PATH NAME)Fremove-all-eas
  146. Remove all extended attribute from the file or directory PATH.
  147.  
  148. (remove-all-eas PATH)Vemx-binary-mode-list
  149. *List of regular expressions.  Binary mode is used for files
  150. matching one of the regular expressions.Vbinary-process-input
  151. *Non-nil means write process input in binary mode.
  152. nil means use file type of the buffer for writing process input.
  153. binary-process-input is examined by call-process and start-process.Vbinary-process-output
  154. *Non-nil means read process output in binary mode.
  155. nil means use file type of the buffer for reading process output.
  156. binary-process-output is examined by call-process and start-process.Vbinary-async-process-input
  157. *Default value for `binary-process-input' if `binary-process-input'
  158. is nil; used for `start-process' only.Vemx-system-type
  159. Underlying operating system (or program loader).
  160. Possible values are `os2' and `ms-dos'.Vprocess-priority
  161. Priority to be assigned to child processes.
  162. Possible values are nil (child processes inherit the priority of Emacs),
  163. a priority class, or (PCLASS . PLEVEL), where PCLASS is a priority
  164. class and PLEVEL is a priority level.  Available priority classes are:
  165.   idle-time (idle-time priority class),
  166.   regular (regular priority class -- this is the OS/2 default,
  167.     a priority boost is applied if the process is in the foreground), and
  168.   foreground-server (fixed-high priority class).
  169. If PLEVEL is omitted or is nil, a priority level of 0 is used.
  170. Otherwise, PLEVEL shall be a number between 0 and 31 which indicates
  171.   the priority level within the priority class.  Level 31 has the highest
  172.   priority in each class, the default value assigned by OS/2 is 0.Vcase-fold-file-names
  173. *`t' if all file names should be translated to lower case.
  174. `nil' if file names should not be translated to lower case.
  175. `preserve' if `expand-file-name' should use text attributes to preserve
  176. case in file names translated to lower case.  This feature is experimental.Vprogram-name-handler-alist
  177. *Alist of elements (REGEXP . HANDLER) for programs handled specially.
  178. If a file name matches REGEXP, then HANDLER is called to take over the work
  179. of call-process and start-process.
  180.  
  181. The first argument given to HANDLER is a list containing the name of the
  182. primitive to be handled and the arguments of the primitive.
  183. For call-process, the list is (call-process INFILE BUFFER DISPLAY);
  184. for start-process, the list is (start-process NAME BUFFER).  The second
  185. argument passed to HANDLER is the file name of the program; the third
  186. argument is a list of the program arguments.  For example, if you do
  187.     (call-process PROGRAM "infile" t nil ARG1 ARG2)
  188. and PROGRAM is handled by HANDLER, then HANDLER is called like this:
  189.     (funcall HANDLER '(call-process "infile" t nil) PROGRAM '(ARG1 ARG2))
  190. HANDLER may modify the structure of its first and third arguments.Vinhibit-program-name-handlers
  191. A list of program name handlers that temporarily should not be used.Vemx-start-session
  192. *Non-nil to let `start-process' create separate sessions.
  193. Nil to let `start-process' run processes in the same session as Emacs.Vremote-expand-file-name
  194. Non-nil to prevent `expand-file-name' from prepending a drive letter.Vemx-kill-tree
  195. Non-nil if signals for process groups should be sent to process tree.
  196. Nil to send signals to the target process only.Ftext-properties-at
  197. Return the list of properties held by the character at POSITION
  198. in optional argument OBJECT, a string or buffer.  If nil, OBJECT
  199. defaults to the current buffer.
  200. If POSITION is at the end of OBJECT, the value is nil.
  201.  
  202. (text-properties-at POSITION &optional OBJECT)Fget-text-property
  203. Return the value of POSITION's property PROP, in OBJECT.
  204. OBJECT is optional and defaults to the current buffer.
  205. If POSITION is at the end of OBJECT, the value is nil.
  206.  
  207. (get-text-property POSITION PROP &optional OBJECT)Fget-char-property
  208. Return the value of POSITION's property PROP, in OBJECT.
  209. OBJECT is optional and defaults to the current buffer.
  210. If POSITION is at the end of OBJECT, the value is nil.
  211. If OBJECT is a buffer, then overlay properties are considered as well as
  212. text properties.
  213. If OBJECT is a window, then that window's buffer is used, but window-specific
  214. overlays are considered only if they are associated with OBJECT.
  215.  
  216. (get-char-property POSITION PROP &optional OBJECT)Fnext-property-change
  217. Return the position of next property change.
  218. Scans characters forward from POSITION in OBJECT till it finds
  219. a change in some text property, then returns the position of the change.
  220. The optional second argument OBJECT is the string or buffer to scan.
  221. Return nil if the property is constant all the way to the end of OBJECT.
  222. If the value is non-nil, it is a position greater than POSITION, never equal.
  223.  
  224. If the optional third argument LIMIT is non-nil, don't search
  225. past position LIMIT; return LIMIT if nothing is found before LIMIT.
  226.  
  227. (next-property-change POSITION &optional OBJECT LIMIT)Fnext-single-property-change
  228. Return the position of next property change for a specific property.
  229. Scans characters forward from POSITION till it finds
  230. a change in the PROP property, then returns the position of the change.
  231. The optional third argument OBJECT is the string or buffer to scan.
  232. The property values are compared with `eq'.
  233. Return nil if the property is constant all the way to the end of OBJECT.
  234. If the value is non-nil, it is a position greater than POSITION, never equal.
  235.  
  236. If the optional fourth argument LIMIT is non-nil, don't search
  237. past position LIMIT; return LIMIT if nothing is found before LIMIT.
  238.  
  239. (next-single-property-change POSITION PROP &optional OBJECT LIMIT)Fprevious-property-change
  240. Return the position of previous property change.
  241. Scans characters backwards from POSITION in OBJECT till it finds
  242. a change in some text property, then returns the position of the change.
  243. The optional second argument OBJECT is the string or buffer to scan.
  244. Return nil if the property is constant all the way to the start of OBJECT.
  245. If the value is non-nil, it is a position less than POSITION, never equal.
  246.  
  247. If the optional third argument LIMIT is non-nil, don't search
  248. back past position LIMIT; return LIMIT if nothing is found until LIMIT.
  249.  
  250. (previous-property-change POSITION &optional OBJECT LIMIT)Fprevious-single-property-change
  251. Return the position of previous property change for a specific property.
  252. Scans characters backward from POSITION till it finds
  253. a change in the PROP property, then returns the position of the change.
  254. The optional third argument OBJECT is the string or buffer to scan.
  255. The property values are compared with `eq'.
  256. Return nil if the property is constant all the way to the start of OBJECT.
  257. If the value is non-nil, it is a position less than POSITION, never equal.
  258.  
  259. If the optional fourth argument LIMIT is non-nil, don't search
  260. back past position LIMIT; return LIMIT if nothing is found until LIMIT.
  261.  
  262. (previous-single-property-change POSITION PROP &optional OBJECT LIMIT)Fadd-text-properties
  263. Add properties to the text from START to END.
  264. The third argument PROPERTIES is a property list
  265. specifying the property values to add.
  266. The optional fourth argument, OBJECT,
  267. is the string or buffer containing the text.
  268. Return t if any property value actually changed, nil otherwise.
  269.  
  270. (add-text-properties START END PROPERTIES &optional OBJECT)Fput-text-property
  271. Set one property of the text from START to END.
  272. The third and fourth arguments PROPERTY and VALUE
  273. specify the property to add.
  274. The optional fifth argument, OBJECT,
  275. is the string or buffer containing the text.
  276.  
  277. (put-text-property START END PROPERTY VALUE &optional OBJECT)Fset-text-properties
  278. Completely replace properties of text from START to END.
  279. The third argument PROPERTIES is the new property list.
  280. The optional fourth argument, OBJECT,
  281. is the string or buffer containing the text.
  282.  
  283. (set-text-properties START END PROPERTIES &optional OBJECT)Fremove-text-properties
  284. Remove some properties from text from START to END.
  285. The third argument PROPERTIES is a property list
  286. whose property names specify the properties to remove.
  287. (The values stored in PROPERTIES are ignored.)
  288. The optional fourth argument, OBJECT,
  289. is the string or buffer containing the text.
  290. Return t if any property was actually removed, nil otherwise.
  291.  
  292. (remove-text-properties START END PROPERTIES &optional OBJECT)Ftext-property-any
  293. Check text from START to END for property PROPERTY equalling VALUE.
  294. If so, return the position of the first character whose property PROPERTY
  295. is `eq' to VALUE.  Otherwise return nil.
  296. The optional fifth argument, OBJECT, is the string or buffer
  297. containing the text.
  298.  
  299. (text-property-any START END PROPERTY VALUE &optional OBJECT)Ftext-property-not-all
  300. Check text from START to END for property PROPERTY not equalling VALUE.
  301. If so, return the position of the first character whose property PROPERTY
  302. is not `eq' to VALUE.  Otherwise, return nil.
  303. The optional fifth argument, OBJECT, is the string or buffer
  304. containing the text.
  305.  
  306. (text-property-not-all START END PROPERTY VALUE &optional OBJECT)Ferase-text-properties
  307. Remove all properties from the text from START to END.
  308. The optional third argument, OBJECT,
  309. is the string or buffer containing the text.
  310.  
  311. (erase-text-properties START END &optional OBJECT)Vdefault-text-properties
  312. Property-list used as default values.
  313. The value of a property in this list is seen as the value for every
  314. character that does not have its own value for that property.Vinhibit-point-motion-hooks
  315. If non-nil, don't run `point-left' and `point-entered' text properties.
  316. This also inhibits the use of the `intangible' text property.Fpm-list-fonts
  317. Return a list of the names of available fonts matching PATTERN.
  318. If optional arguments FACE and FRAME are specified, return only fonts
  319. the same size as FACE on FRAME.
  320.  
  321. PATTERN is a string, perhaps with wildcard characters;
  322.   the * character matches any substring, and
  323.   the ? character matches any single character.
  324.   PATTERN is case-insensitive.
  325. FACE is a face name - a symbol.
  326.  
  327. The return value is a list of strings, suitable as arguments to
  328. set-face-font.
  329.  
  330. The list does not include fonts Emacs can't use (i.e.  proportional
  331. fonts), even if they match PATTERN and FACE.
  332.  
  333. (pm-list-fonts PATTERN &optional FACE FRAME)Fpm-color-defined-p
  334. Return non-nil if color COLOR is supported on frame FRAME.
  335. if FRAME is omitted or nil, use the selected frame.
  336.  
  337. (pm-color-defined-p COLOR &optional FRAME)Fpm-color-values
  338. Return a description of the color named COLOR on frame FRAME.
  339. The value is a list of integer RGB values--(RED GREEN BLUE).
  340. These values appear to range from 0 to 65280 or 65535, depending
  341. on the system; white is (65280 65280 65280) or (65535 65535 65535).
  342. If FRAME is omitted or nil, use the selected frame.
  343.  
  344. (pm-color-values COLOR &optional FRAME)Fpm-display-color-p
  345. Return t if the display supports color.
  346. The optional argument DISPLAY specifies which display to ask about.
  347. DISPLAY should be either a frame or a display name (a string).
  348. If omitted or nil, that stands for the selected frame's display.
  349.  
  350. (pm-display-color-p &optional DISPLAY)Fpm-display-grayscale-p
  351. Return t if the X display supports shades of gray.
  352. The optional argument DISPLAY specifies which display to ask about.
  353. DISPLAY should be either a frame or a display name (a string).
  354. If omitted or nil, that stands for the selected frame's display.
  355.  
  356. (pm-display-grayscale-p &optional DISPLAY)Fx-display-pixel-width
  357. Returns the width in pixels of the X display DISPLAY.
  358. The optional argument DISPLAY specifies which display to ask about.
  359. DISPLAY should be either a frame or a display name (a string).
  360. If omitted or nil, that stands for the selected frame's display.
  361.  
  362. (x-display-pixel-width &optional DISPLAY)Fx-display-pixel-height
  363. Returns the height in pixels of the X display DISPLAY.
  364. The optional argument DISPLAY specifies which display to ask about.
  365. DISPLAY should be either a frame or a display name (a string).
  366. If omitted or nil, that stands for the selected frame's display.
  367.  
  368. (x-display-pixel-height &optional DISPLAY)Fpm-display-planes
  369. Returns the number of bitplanes of the display FRAME is on.
  370. The optional argument DISPLAY specifies which display to ask about.
  371. DISPLAY should be either a frame or a display name (a string).
  372. If omitted or nil, that stands for the selected frame's display.
  373.  
  374. (pm-display-planes &optional DISPLAY)Fpm-display-color-cells
  375. Returns the number of color cells of the display DISPLAY.
  376. The optional argument DISPLAY specifies which display to ask about.
  377. DISPLAY should be either a frame or a display name (a string).
  378. If omitted or nil, that stands for the selected frame's display.
  379.  
  380. (pm-display-color-cells &optional DISPLAY)Fx-display-screens
  381. Returns the number of screens on the X server of display DISPLAY.
  382. The optional argument DISPLAY specifies which display to ask about.
  383. DISPLAY should be either a frame or a display name (a string).
  384. If omitted or nil, that stands for the selected frame's display.
  385.  
  386. (x-display-screens &optional DISPLAY)Fx-display-mm-height
  387. Returns the height in millimeters of the X display DISPLAY.
  388. The optional argument DISPLAY specifies which display to ask about.
  389. DISPLAY should be either a frame or a display name (a string).
  390. If omitted or nil, that stands for the selected frame's display.
  391.  
  392. (x-display-mm-height &optional DISPLAY)Fx-display-mm-width
  393. Returns the width in millimeters of the X display DISPLAY.
  394. The optional argument DISPLAY specifies which display to ask about.
  395. DISPLAY should be either a frame or a display name (a string).
  396. If omitted or nil, that stands for the selected frame's display.
  397.  
  398. (x-display-mm-width &optional DISPLAY)Fpm-open-connection
  399. Open a connection to PM Emacs.
  400.  
  401. (pm-open-connection)Fx-close-connection
  402. Close the connection to DISPLAY's X server.
  403. For DISPLAY, specify either a frame or a display name (a string).
  404. If DISPLAY is nil, that stands for the selected frame's display.
  405.  
  406. (x-close-connection DISPLAY)Fx-display-list
  407. Return the list of display names that Emacs has connections to.
  408.  
  409. (x-display-list)Ffocus-frame
  410. Set the focus on FRAME.
  411.  
  412. (focus-frame FRAME)Funfocus-frame
  413. If a frame has been focused, release it.
  414.  
  415. (unfocus-frame)Fpm-create-frame
  416. Make a new PM window, which is called a "frame" in Emacs terms.
  417. Return an Emacs frame object.
  418. ALIST is an alist of frame parameters.
  419. If the parameters specify that the frame should not have a minibuffer,
  420. and do not specify a specific minibuffer window to use,
  421. then `default-minibuffer-frame' must be a frame whose minibuffer can
  422. be shared by the new frame.
  423.  
  424. This function is an internal primitive--use `make-frame' instead.
  425.  
  426. (pm-create-frame PARMS)Fpm-get-drop
  427. Get name of dropped object.
  428. TIMESTAMP is the timestamp of the event.
  429. Return nil if there is no such object.
  430.  
  431. (pm-get-drop TIMESTAMP)Fpm-file-dialog
  432. Show and process a file dialog on frame FRAME with TITLE.
  433. If FRAME is nil, use the current frame.  The default directory is DIR,
  434. which is not expanded---you must call `expand-file-name' yourself.
  435. The initial value of the file-name entryfield is DEFAULT or empty if
  436. DEFAULT is nil.  Fifth arg MUSTMATCH non-nil means require existing
  437. file's name.  Sixth arg SAVEAS non-nil creates a Save As dialog instead
  438. of a Open dialog.  Seventh arg BUTTON specifies text to for the OK button,
  439. the default is "OK".
  440. Return the select file name as string.  Return nil, if no file name was
  441. selected.
  442.  
  443. (pm-file-dialog FRAME TITLE DIR &optional DEFAULT MUSTMATCH SAVEAS BUTTON)Vpm-color-alist
  444. *List of elements ("COLOR" . [R G B]) for defining colors.
  445. "COLOR" is the name of the color.  Don't use upper-case letters.
  446. R, G and B are numbers in 0 through 255, indicating the intensity
  447. of the red, green and blue beams, respectively.Fx-selection-owner-p
  448. Whether the current Emacs process owns the given X Selection.
  449. The arg should be the name of the selection in question, typically one of
  450. the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  451. (Those are literal upper-case symbol names, since that's what X expects.)
  452. For convenience, the symbol nil is the same as `PRIMARY',
  453. and t is the same as `SECONDARY'.)
  454.  
  455. (x-selection-owner-p &optional SELECTION)Fx-selection-exists-p
  456. Whether there is an owner for the given X Selection.
  457. The arg should be the name of the selection in question, typically one of
  458. the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  459. (Those are literal upper-case symbol names, since that's what X expects.)
  460. For convenience, the symbol nil is the same as `PRIMARY',
  461. and t is the same as `SECONDARY'.)
  462.  
  463. (x-selection-exists-p &optional SELECTION)Fpm-get-clipboard
  464. Retrieve a text string from the clipboard.
  465. Return the empty string if there is no text in the clipboard.
  466.  
  467. (pm-get-clipboard)Fpm-clipboard-ready-p
  468. Return t if a text is in the clipboard.
  469.  
  470. (pm-clipboard-ready-p)Fpm-put-clipboard
  471. Put a text string into the clipboard.
  472.  
  473. (pm-put-clipboard STRING)Fpixmap-spec-p
  474. Return t if OBJECT is a valid pixmap specification.
  475.  
  476. (pixmap-spec-p OBJECT)Fframe-face-alist
  477.  
  478.  
  479. (frame-face-alist FRAME)Fset-frame-face-alist
  480.  
  481.  
  482. (set-frame-face-alist FRAME VALUE)Fmake-face-internal
  483. Create face number FACE-ID on all frames.
  484.  
  485. (make-face-internal FACE-ID)Fset-face-attribute-internal
  486.  
  487.  
  488. (set-face-attribute-internal FACE-ID ATTR-NAME ATTR-VALUE FRAME)Finternal-next-face-id
  489.  
  490.  
  491. (internal-next-face-id)Vregion-face
  492. Face number to use to highlight the region
  493. The region is highlighted with this face
  494. when Transient Mark mode is enabled and the mark is active.Fx-popup-menu
  495. Pop up a deck-of-cards menu and return user's selection.
  496. POSITION is a position specification.  This is either a mouse button event
  497. or a list ((XOFFSET YOFFSET) WINDOW)
  498. where XOFFSET and YOFFSET are positions in pixels from the top left
  499. corner of WINDOW's frame.  (WINDOW may be a frame object instead of a window.)
  500. This controls the position of the center of the first line
  501. in the first pane of the menu, not the top left of the menu as a whole.
  502. If POSITION is t, it means to use the current mouse position.
  503.  
  504. MENU is a specifier for a menu.  For the simplest case, MENU is a keymap.
  505. The menu items come from key bindings that have a menu string as well as
  506. a definition; actually, the "definition" in such a key binding looks like
  507. (STRING . REAL-DEFINITION).  To give the menu a title, put a string into
  508. the keymap as a top-level element.
  509.  
  510. You can also use a list of keymaps as MENU.
  511.   Then each keymap makes a separate pane.
  512. When MENU is a keymap or a list of keymaps, the return value
  513. is a list of events.
  514.  
  515. Alternatively, you can specify a menu of multiple panes
  516.   with a list of the form (TITLE PANE1 PANE2...),
  517. where each pane is a list of form (TITLE ITEM1 ITEM2...).
  518. Each ITEM is normally a cons cell (STRING . VALUE);
  519. but a string can appear as an item--that makes a nonselectable line
  520. in the menu.
  521. With this form of menu, the return value is VALUE from the chosen item.
  522.  
  523. If POSITION is nil, don't display the menu at all, just precalculate the
  524. cached information about equivalent key sequences.
  525.  
  526. (x-popup-menu POSITION MENU)Fx-popup-dialog
  527. Pop up a dialog box and return user's selection.
  528. POSITION specifies which frame to use.
  529. This is normally a mouse button event or a window or frame.
  530. If POSITION is t, it means to use the frame the mouse is on.
  531. The dialog box appears in the middle of the specified frame.
  532.  
  533. CONTENTS specifies the alternatives to display in the dialog box.
  534. It is a list of the form (TITLE ITEM1 ITEM2...).
  535. Each ITEM is a cons cell (STRING . VALUE).
  536. The return value is VALUE from the chosen item.
  537.  
  538. An ITEM may also be just a string--that makes a nonselectable item.
  539. An ITEM may also be nil--that means to put all preceding items
  540. on the left of the dialog box and all following items on the right.
  541. (By default, approximately half appear on each side.)
  542.  
  543. (x-popup-dialog POSITION CONTENTS)Vpm-align-menu-key-descriptions
  544. *Non-nil means align key descriptions in menus.
  545. nil means put key descriptions directly after the title of a
  546. menu item, in parentheses.  You should set this variable
  547. in your startup file because it is ignored after computing
  548. the keyboard equivalents for menus.Vpm-popup-menu-align-top
  549. *Non-nil means put the top item of a popup menu at the mouse position.
  550. nil means put the bottom item of a popup menu at the mouse position.Fredraw-frame
  551. Clear frame FRAME and output again what is supposed to appear on it.
  552.  
  553. (redraw-frame FRAME)Fredraw-display
  554. Clear and redisplay all visible frames.
  555.  
  556. (redraw-display)Fframe-or-buffer-changed-p
  557. Return non-nil if the frame and buffer state appears to have changed.
  558. The state variable is an internal vector containing all frames and buffers,
  559. aside from buffers whose names start with space,
  560. along with the buffers' read-only and modified flags, which allows a fast
  561. check to see whether the menu bars might need to be recomputed.
  562. If this function returns non-nil, it updates the internal vector to reflect
  563. the current state.
  564.  
  565.  
  566. (frame-or-buffer-changed-p)Fopen-termscript
  567. Start writing all terminal output to FILE as well as the terminal.
  568. FILE = nil means just close any termscript file currently open.
  569.  
  570. (open-termscript FILE)Fsend-string-to-terminal
  571. Send STRING to the terminal without alteration.
  572. Control characters in STRING will have terminal-dependent effects.
  573.  
  574. (send-string-to-terminal STRING)Fding
  575. Beep, or flash the screen.
  576. Also, unless an argument is given,
  577. terminate any keyboard macro currently executing.
  578.  
  579. (ding &optional ARG)Fsleep-for
  580. Pause, without updating display, for SECONDS seconds.
  581. SECONDS may be a floating-point value, meaning that you can wait for a
  582. fraction of a second.  Optional second arg MILLISECONDS specifies an
  583. additional wait period, in milliseconds; this may be useful if your
  584. Emacs was built without floating point support.
  585. (Not all operating systems support waiting for a fraction of a second.)
  586.  
  587. (sleep-for SECONDS &optional MILLISECONDS)Fsit-for
  588. Perform redisplay, then wait for SECONDS seconds or until input is available.
  589. SECONDS may be a floating-point value, meaning that you can wait for a
  590. fraction of a second.  Optional second arg MILLISECONDS specifies an
  591. additional wait period, in milliseconds; this may be useful if your
  592. Emacs was built without floating point support.
  593. (Not all operating systems support waiting for a fraction of a second.)
  594. Optional third arg NODISP non-nil means don't redisplay, just wait for input.
  595. Redisplay is preempted as always if input arrives, and does not happen
  596. if input is available before it starts.
  597. Value is t if waited the full time with no input arriving.
  598.  
  599. (sit-for SECONDS &optional MILLISECONDS NODISP)Vbaud-rate
  600. *The output baud rate of the terminal.
  601. On most systems, changing this value will affect the amount of padding
  602. and the other strategic decisions made during redisplay.Vinverse-video
  603. *Non-nil means invert the entire frame display.
  604. This means everything is in inverse video which otherwise would not be.Vvisible-bell
  605. *Non-nil means try to flash the frame to represent a bell.Vno-redraw-on-reenter
  606. *Non-nil means no need to redraw entire frame after suspending.
  607. A non-nil value is useful if the terminal can automatically preserve
  608. Emacs's frame display when you reenter Emacs.
  609. It is up to you to set this variable if your terminal can do that.Vwindow-system
  610. A symbol naming the window-system under which Emacs is running
  611. (such as `x'), or nil if emacs is running on an ordinary terminal.Vwindow-system-version
  612. The version number of the window system in use.
  613. For X windows, this is 10 or 11.Vcursor-in-echo-area
  614. Non-nil means put cursor in minibuffer, at end of any message there.Vglyph-table
  615. Table defining how to output a glyph code to the frame.
  616. If not nil, this is a vector indexed by glyph code to define the glyph.
  617. Each element can be:
  618.  integer: a glyph code which this glyph is an alias for.
  619.  string: output this glyph using that string (not impl. in X windows).
  620.  nil: this glyph mod 256 is char code to output,
  621.     and this glyph / 256 is face code for X windows (see `face-id').Vstandard-display-table
  622. Display table to use for buffers that specify none.
  623. See `buffer-display-table' for more information.Vmin-skip-run
  624. Minimum run length required for skipping matching characters in output.
  625. This is used for tuning output.Vdefault-frame-alist
  626. Alist of default values for frame creation.
  627. These may be set in your init file, like this:
  628.   (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1))
  629. These override values given in window system configuration data,
  630.  including X Windows' defaults database.
  631. For values specific to the first Emacs frame, see `initial-frame-alist'.
  632. For values specific to the separate minibuffer frame, see
  633.  `minibuffer-frame-alist'.
  634. The `menu-bar-lines' element of the list controls whether new frames
  635.  have menu bars; `menu-bar-mode' works by altering this element.Fframep
  636. Return non-nil if OBJECT is a frame.
  637. Value is t for a termcap frame (a character-only terminal),
  638. `x' for an Emacs frame that is really an X window,
  639. `pm' for an Emacs frame that is really a Presentation Manager window,
  640. `pc' for a direct-write MS-DOS frame.
  641. See also `frame-live-p'.
  642.  
  643. (framep OBJECT)Fframe-live-p
  644. Return non-nil if OBJECT is a frame which has not been deleted.
  645. Value is nil if OBJECT is not a live frame.  If object is a live
  646. frame, the return value indicates what sort of output device it is
  647. displayed on.  Value is t for a termcap frame (a character-only
  648. terminal), `x' for an Emacs frame being displayed in an X window.
  649.  
  650. (frame-live-p OBJECT)Fmake-terminal-frame
  651. Create an additional terminal frame.
  652. You can create multiple frames on a text-only terminal in this way.
  653. Only the selected terminal frame is actually displayed.
  654. This function takes one argument, an alist specifying frame parameters.
  655. In practice, generally you don't need to specify any parameters.
  656. Note that changing the size of one terminal frame automatically affects all.
  657.  
  658. (make-terminal-frame PARMS)Fselect-frame
  659. Select the frame FRAME.
  660. Subsequent editing commands apply to its selected window.
  661. The selection of FRAME lasts until the next time the user does
  662. something to select a different frame, or until the next time this
  663. function is called.
  664.  
  665. (select-frame FRAME &optional NO-ENTER)Fhandle-switch-frame
  666. Handle a switch-frame event EVENT.
  667. Switch-frame events are usually bound to this function.
  668. A switch-frame event tells Emacs that the window manager has requested
  669. that the user's events be directed to the frame mentioned in the event.
  670. This function selects the selected window of the frame of EVENT.
  671.  
  672. If EVENT is frame object, handle it as if it were a switch-frame event
  673. to that frame.
  674.  
  675. (handle-switch-frame EVENT &optional NO-ENTER)Fignore-event
  676. Do nothing, but preserve any prefix argument already specified.
  677. This is a suitable binding for iconify-frame and make-frame-visible.
  678.  
  679. (ignore-event)Fselected-frame
  680. Return the frame that is now selected.
  681.  
  682. (selected-frame)Fwindow-frame
  683. Return the frame object that window WINDOW is on.
  684.  
  685. (window-frame WINDOW)Fframe-first-window
  686. Returns the topmost, leftmost window of FRAME.
  687. If omitted, FRAME defaults to the currently selected frame.
  688.  
  689. (frame-first-window &optional FRAME)Factive-minibuffer-window
  690. Return the currently active minibuffer window, or nil if none.
  691.  
  692. (active-minibuffer-window)Fframe-root-window
  693. Returns the root-window of FRAME.
  694. If omitted, FRAME defaults to the currently selected frame.
  695.  
  696. (frame-root-window &optional FRAME)Fframe-selected-window
  697. Return the selected window of frame object FRAME.
  698. If omitted, FRAME defaults to the currently selected frame.
  699.  
  700. (frame-selected-window &optional FRAME)Fset-frame-selected-window
  701. Set the selected window of frame object FRAME to WINDOW.
  702. If FRAME is nil, the selected frame is used.
  703. If FRAME is the selected frame, this makes WINDOW the selected window.
  704.  
  705. (set-frame-selected-window FRAME WINDOW)Fframe-list
  706. Return a list of all frames.
  707.  
  708. (frame-list)Fnext-frame
  709. Return the next frame in the frame list after FRAME.
  710. It considers only frames on the same terminal as FRAME.
  711. By default, skip minibuffer-only frames.
  712. If omitted, FRAME defaults to the selected frame.
  713. If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
  714. If MINIFRAME is a window, include only its own frame
  715. and any frame now using that window as the minibuffer.
  716. If MINIFRAME is `visible', include all visible frames.
  717. If MINIFRAME is 0, include all visible and iconified frames.
  718. Otherwise, include all frames.
  719.  
  720. (next-frame &optional FRAME MINIFRAME)Fprevious-frame
  721. Return the previous frame in the frame list before FRAME.
  722. It considers only frames on the same terminal as FRAME.
  723. By default, skip minibuffer-only frames.
  724. If omitted, FRAME defaults to the selected frame.
  725. If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
  726. If MINIFRAME is a window, include only its own frame
  727. and any frame now using that window as the minibuffer.
  728. If MINIFRAME is `visible', include all visible frames.
  729. If MINIFRAME is 0, include all visible and iconified frames.
  730. Otherwise, include all frames.
  731.  
  732. (previous-frame &optional FRAME MINIFRAME)Fdelete-frame
  733. Delete FRAME, permanently eliminating it from use.
  734. If omitted, FRAME defaults to the selected frame.
  735. A frame may not be deleted if its minibuffer is used by other frames.
  736. Normally, you may not delete a frame if all other frames are invisible,
  737. but if the second optional argument FORCE is non-nil, you may do so.
  738.  
  739. (delete-frame &optional FRAME FORCE)Fmouse-position
  740. Return a list (FRAME X . Y) giving the current mouse frame and position.
  741. The position is given in character cells, where (0, 0) is the
  742. upper-left corner.
  743. If Emacs is running on a mouseless terminal or hasn't been programmed
  744. to read the mouse position, it returns the selected frame for FRAME
  745. and nil for X and Y.
  746.  
  747. (mouse-position)Fmouse-pixel-position
  748. Return a list (FRAME X . Y) giving the current mouse frame and position.
  749. The position is given in pixel units, where (0, 0) is the
  750. upper-left corner.
  751. If Emacs is running on a mouseless terminal or hasn't been programmed
  752. to read the mouse position, it returns the selected frame for FRAME
  753. and nil for X and Y.
  754.  
  755. (mouse-pixel-position)Fset-mouse-position
  756. Move the mouse pointer to the center of character cell (X,Y) in FRAME.
  757. Note, this is a no-op for an X frame that is not visible.
  758. If you have just created a frame, you must wait for it to become visible
  759. before calling this function on it, like this.
  760.   (while (not (frame-visible-p frame)) (sleep-for .5))
  761.  
  762. (set-mouse-position FRAME X Y)Fset-mouse-pixel-position
  763. Move the mouse pointer to pixel position (X,Y) in FRAME.
  764. Note, this is a no-op for an X frame that is not visible.
  765. If you have just created a frame, you must wait for it to become visible
  766. before calling this function on it, like this.
  767.   (while (not (frame-visible-p frame)) (sleep-for .5))
  768.  
  769. (set-mouse-pixel-position FRAME X Y)Fmake-frame-visible
  770. Make the frame FRAME visible (assuming it is an X-window).
  771. If omitted, FRAME defaults to the currently selected frame.
  772.  
  773. (make-frame-visible &optional FRAME)Fmake-frame-invisible
  774. Make the frame FRAME invisible (assuming it is an X-window).
  775. If omitted, FRAME defaults to the currently selected frame.
  776. Normally you may not make FRAME invisible if all other frames are invisible,
  777. but if the second optional argument FORCE is non-nil, you may do so.
  778.  
  779. (make-frame-invisible &optional FRAME FORCE)Ficonify-frame
  780. Make the frame FRAME into an icon.
  781. If omitted, FRAME defaults to the currently selected frame.
  782.  
  783. (iconify-frame &optional FRAME)Fframe-visible-p
  784. Return t if FRAME is now "visible" (actually in use for display).
  785. A frame that is not "visible" is not updated and, if it works through
  786. a window system, it may not show at all.
  787. Return the symbol `icon' if frame is visible only as an icon.
  788.  
  789. (frame-visible-p FRAME)Fvisible-frame-list
  790. Return a list of all frames now "visible" (being updated).
  791.  
  792. (visible-frame-list)Fraise-frame
  793. Bring FRAME to the front, so it occludes any frames it overlaps.
  794. If FRAME is invisible, make it visible.
  795. If you don't specify a frame, the selected frame is used.
  796. If Emacs is displaying on an ordinary terminal or some other device which
  797. doesn't support multiple overlapping frames, this function does nothing.
  798.  
  799. (raise-frame &optional FRAME)Flower-frame
  800. Send FRAME to the back, so it is occluded by any frames that overlap it.
  801. If you don't specify a frame, the selected frame is used.
  802. If Emacs is displaying on an ordinary terminal or some other device which
  803. doesn't support multiple overlapping frames, this function does nothing.
  804.  
  805. (lower-frame &optional FRAME)Fredirect-frame-focus
  806. Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
  807. In other words, switch-frame events caused by events in FRAME will
  808. request a switch to FOCUS-FRAME, and `last-event-frame' will be
  809. FOCUS-FRAME after reading an event typed at FRAME.
  810.  
  811. If FOCUS-FRAME is omitted or nil, any existing redirection is
  812. cancelled, and the frame again receives its own keystrokes.
  813.  
  814. Focus redirection is useful for temporarily redirecting keystrokes to
  815. a surrogate minibuffer frame when a frame doesn't have its own
  816. minibuffer window.
  817.  
  818. A frame's focus redirection can be changed by select-frame.  If frame
  819. FOO is selected, and then a different frame BAR is selected, any
  820. frames redirecting their focus to FOO are shifted to redirect their
  821. focus to BAR.  This allows focus redirection to work properly when the
  822. user switches from one frame to another using `select-window'.
  823.  
  824. This means that a frame whose focus is redirected to itself is treated
  825. differently from a frame whose focus is redirected to nil; the former
  826. is affected by select-frame, while the latter is not.
  827.  
  828. The redirection lasts until `redirect-frame-focus' is called to change it.
  829.  
  830. (redirect-frame-focus FRAME &optional FOCUS-FRAME)Fframe-focus
  831. Return the frame to which FRAME's keystrokes are currently being sent.
  832. This returns nil if FRAME's focus is not redirected.
  833. See `redirect-frame-focus'.
  834.  
  835. (frame-focus FRAME)Fframe-parameters
  836. Return the parameters-alist of frame FRAME.
  837. It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
  838. The meaningful PARMs depend on the kind of frame.
  839. If FRAME is omitted, return information on the currently selected frame.
  840.  
  841. (frame-parameters &optional FRAME)Fmodify-frame-parameters
  842. Modify the parameters of frame FRAME according to ALIST.
  843. ALIST is an alist of parameters to change and their new values.
  844. Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
  845. The meaningful PARMs depend on the kind of frame; undefined PARMs are ignored.
  846.  
  847. (modify-frame-parameters FRAME ALIST)Fframe-char-height
  848. Height in pixels of a line in the font in frame FRAME.
  849. If FRAME is omitted, the selected frame is used.
  850. For a terminal frame, the value is always 1.
  851.  
  852. (frame-char-height &optional FRAME)Fframe-char-width
  853. Width in pixels of characters in the font in frame FRAME.
  854. If FRAME is omitted, the selected frame is used.
  855. The width is the same for all characters, because
  856. currently Emacs supports only fixed-width fonts.
  857. For a terminal screen, the value is always 1.
  858.  
  859. (frame-char-width &optional FRAME)Fframe-pixel-height
  860. Return a FRAME's height in pixels.
  861. For a terminal frame, the result really gives the height in characters.
  862. If FRAME is omitted, the selected frame is used.
  863.  
  864. (frame-pixel-height &optional FRAME)Fframe-pixel-width
  865. Return FRAME's width in pixels.
  866. For a terminal frame, the result really gives the width in characters.
  867. If FRAME is omitted, the selected frame is used.
  868.  
  869. (frame-pixel-width &optional FRAME)Fset-frame-height
  870. Specify that the frame FRAME has LINES lines.
  871. Optional third arg non-nil means that redisplay should use LINES lines
  872. but that the idea of the actual height of the frame should not be changed.
  873.  
  874. (set-frame-height FRAME LINES &optional PRETEND)Fset-frame-width
  875. Specify that the frame FRAME has COLS columns.
  876. Optional third arg non-nil means that redisplay should use COLS columns
  877. but that the idea of the actual width of the frame should not be changed.
  878.  
  879. (set-frame-width FRAME COLS &optional PRETEND)Fset-frame-size
  880. Sets size of FRAME to COLS by ROWS, measured in characters.
  881.  
  882. (set-frame-size FRAME COLS ROWS)Fset-frame-position
  883. Sets position of FRAME in pixels to XOFFSET by YOFFSET.
  884. This is actually the position of the upper left corner of the frame.
  885. Negative values for XOFFSET or YOFFSET are interpreted relative to
  886. the rightmost or bottommost possible position (that stays within the screen).
  887.  
  888. (set-frame-position FRAME XOFFSET YOFFSET)Vterminal-frame
  889. The initial frame-object, which represents Emacs's stdout.Vemacs-iconified
  890. Non-nil if all of emacs is iconified and frame updates are not needed.Vdefault-minibuffer-frame
  891. Minibufferless frames use this frame's minibuffer.
  892.  
  893. Emacs cannot create minibufferless frames unless this is set to an
  894. appropriate surrogate.
  895.  
  896. Emacs consults this variable only when creating minibufferless
  897. frames; once the frame is created, it sticks with its assigned
  898. minibuffer, no matter what this variable is set to.  This means that
  899. this variable doesn't necessarily say anything meaningful about the
  900. current set of frames, or where the minibuffer is currently being
  901. displayed.Vglobal-mode-string
  902. String (or mode line construct) included (normally) in `mode-line-format'.Voverlay-arrow-position
  903. Marker for where to display an arrow on top of the buffer text.
  904. This must be the beginning of a line in order to work.
  905. See also `overlay-arrow-string'.Voverlay-arrow-string
  906. String to display as an arrow.  See also `overlay-arrow-position'.Vscroll-step
  907. *The number of lines to try scrolling a window by when point moves out.
  908. If that fails to bring point back on frame, point is centered instead.
  909. If this is zero, point is always centered after it moves off frame.Vdebug-end-pos
  910. Don't askVtruncate-partial-width-windows
  911. *Non-nil means truncate lines in all windows less than full frame wide.Vmode-line-inverse-video
  912. *Non-nil means use inverse video for the mode line.Vline-number-display-limit
  913. *Maximum buffer size for which line number should be displayed.Vhighlight-nonselected-windows
  914. *Non-nil means highlight region even in nonselected windows.Vmultiple-frames
  915. Non-nil if more than one frame is visible on this display.
  916. Minibuffer-only frames don't count, but iconified frames do.
  917. This variable is not guaranteed to be accurate except while processing
  918. `frame-title-format' and `icon-title-format'.Vframe-title-format
  919. Template for displaying the titlebar of visible frames.
  920. (Assuming the window manager supports this feature.)
  921. This variable has the same structure as `mode-line-format' (which see),
  922. and is used only on frames for which no explicit name has been set
  923. (see `modify-frame-parameters').Vicon-title-format
  924. Template for displaying the titlebar of an iconified frame.
  925. (Assuming the window manager supports this feature.)
  926. This variable has the same structure as `mode-line-format' (which see),
  927. and is used only on frames for which no explicit name has been set
  928. (see `modify-frame-parameters').Vmessage-log-max
  929. Maximum number of lines to keep in the message log buffer.
  930. If nil, disable message logging.  If t, log messages but don't truncate
  931. the buffer when it becomes large.Vwindow-size-change-functions
  932. Functions called before redisplay, if window sizes have changed.
  933. The value should be a list of functions that take one argument.
  934. Just before redisplay, for each frame, if any of its windows have changed
  935. size since the last redisplay, or have been split or deleted,
  936. all the functions in the list are called, with the frame as argument.Vwindow-scroll-functions
  937. List of Functions to call before redisplaying a window with scrolling.
  938. Each function is called with two arguments, the window
  939. and its new display-start position.  Note that the value of `window-end'
  940. is not valid when these functions are called.Fwindowp
  941. Returns t if OBJECT is a window.
  942.  
  943. (windowp OBJECT)Fwindow-live-p
  944. Returns t if OBJECT is a window which is currently visible.
  945.  
  946. (window-live-p OBJECT)Fselected-window
  947. Return the window that the cursor now appears in and commands apply to.
  948.  
  949. (selected-window)Fminibuffer-window
  950. Return the window used now for minibuffers.
  951. If the optional argument FRAME is specified, return the minibuffer window
  952. used by that frame.
  953.  
  954. (minibuffer-window &optional FRAME)Fwindow-minibuffer-p
  955. Returns non-nil if WINDOW is a minibuffer window.
  956.  
  957. (window-minibuffer-p &optional WINDOW)Fpos-visible-in-window-p
  958. Return t if position POS is currently on the frame in WINDOW.
  959. Returns nil if that position is scrolled vertically out of view.
  960. POS defaults to point; WINDOW, to the selected window.
  961.  
  962. (pos-visible-in-window-p &optional POS WINDOW)Fwindow-buffer
  963. Return the buffer that WINDOW is displaying.
  964.  
  965. (window-buffer &optional WINDOW)Fwindow-height
  966. Return the number of lines in WINDOW (including its mode line).
  967.  
  968. (window-height &optional WINDOW)Fwindow-width
  969. Return the number of display columns in WINDOW.
  970. This is the width that is usable columns available for text in WINDOW.
  971. If you want to find out how many columns WINDOW takes up,
  972. use  (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))).
  973.  
  974. (window-width &optional WINDOW)Fwindow-hscroll
  975. Return the number of columns by which WINDOW is scrolled from left margin.
  976.  
  977. (window-hscroll &optional WINDOW)Fset-window-hscroll
  978. Set number of columns WINDOW is scrolled from left margin to NCOL.
  979. NCOL should be zero or positive.
  980.  
  981. (set-window-hscroll WINDOW NCOL)Fwindow-redisplay-end-trigger
  982. Return WINDOW's redisplay end trigger value.
  983. See `set-window-redisplay-end-trigger' for more information.
  984.  
  985. (window-redisplay-end-trigger &optional WINDOW)Fset-window-redisplay-end-trigger
  986. Set WINDOW's redisplay end trigger value to VALUE.
  987. VALUE should be a buffer position (typically a marker) or nil.
  988. If it is a buffer position, then if redisplay in WINDOW reaches a position
  989. beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
  990. with two arguments: WINDOW, and the end trigger value.
  991. Afterwards the end-trigger value is reset to nil.
  992.  
  993. (set-window-redisplay-end-trigger WINDOW VALUE)Fwindow-edges
  994. Return a list of the edge coordinates of WINDOW.
  995. (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
  996. RIGHT is one more than the rightmost column used by WINDOW,
  997. and BOTTOM is one more than the bottommost row used by WINDOW
  998.  and its mode-line.
  999.  
  1000. (window-edges &optional WINDOW)Fcoordinates-in-window-p
  1001. Return non-nil if COORDINATES are in WINDOW.
  1002. COORDINATES is a cons of the form (X . Y), X and Y being distances
  1003. measured in characters from the upper-left corner of the frame.
  1004. (0 .  0) denotes the character in the upper left corner of the
  1005. frame.
  1006. If COORDINATES are in the text portion of WINDOW,
  1007.    the coordinates relative to the window are returned.
  1008. If they are in the mode line of WINDOW, `mode-line' is returned.
  1009. If they are on the border between WINDOW and its right sibling,
  1010.    `vertical-line' is returned.
  1011.  
  1012. (coordinates-in-window-p COORDINATES WINDOW)Fwindow-at
  1013. Return window containing coordinates X and Y on FRAME.
  1014. If omitted, FRAME defaults to the currently selected frame.
  1015. The top left corner of the frame is considered to be row 0,
  1016. column 0.
  1017.  
  1018. (window-at X Y &optional FRAME)Fwindow-point
  1019. Return current value of point in WINDOW.
  1020. For a nonselected window, this is the value point would have
  1021. if that window were selected.
  1022.  
  1023. Note that, when WINDOW is the selected window and its buffer
  1024. is also currently selected, the value returned is the same as (point).
  1025. It would be more strictly correct to return the `top-level' value
  1026. of point, outside of any save-excursion forms.
  1027. But that is hard to define.
  1028.  
  1029. (window-point &optional WINDOW)Fwindow-start
  1030. Return position at which display currently starts in WINDOW.
  1031. This is updated by redisplay or by calling `set-window-start'.
  1032.  
  1033. (window-start &optional WINDOW)Fwindow-end
  1034. Return position at which display currently ends in WINDOW.
  1035. This is updated by redisplay, when it runs to completion.
  1036. Simply changing the buffer text or setting `window-start'
  1037. does not update this value.
  1038.  
  1039. (window-end &optional WINDOW)Fset-window-point
  1040. Make point value in WINDOW be at position POS in WINDOW's buffer.
  1041.  
  1042. (set-window-point WINDOW POS)Fset-window-start
  1043. Make display in WINDOW start at position POS in WINDOW's buffer.
  1044. Optional third arg NOFORCE non-nil inhibits next redisplay
  1045. from overriding motion of point in order to display at this exact start.
  1046.  
  1047. (set-window-start WINDOW POS &optional NOFORCE)Fwindow-dedicated-p
  1048. Return WINDOW's dedicated object, usually t or nil.
  1049. See also `set-window-dedicated-p'.
  1050.  
  1051. (window-dedicated-p WINDOW)Fset-window-dedicated-p
  1052. Control whether WINDOW is dedicated to the buffer it displays.
  1053. If it is dedicated, Emacs will not automatically change
  1054. which buffer appears in it.
  1055. The second argument is the new value for the dedication flag;
  1056. non-nil means yes.
  1057.  
  1058. (set-window-dedicated-p WINDOW ARG)Fwindow-display-table
  1059. Return the display-table that WINDOW is using.
  1060.  
  1061. (window-display-table &optional WINDOW)Fset-window-display-table
  1062. Set WINDOW's display-table to TABLE.
  1063.  
  1064. (set-window-display-table WINDOW TABLE)Fdelete-window
  1065. Remove WINDOW from the display.  Default is selected window.
  1066.  
  1067. (delete-window &optional WINDOW)Fnext-window
  1068. Return next window after WINDOW in canonical ordering of windows.
  1069. If omitted, WINDOW defaults to the selected window.
  1070.  
  1071. Optional second arg MINIBUF t means count the minibuffer window even
  1072. if not active.  MINIBUF nil or omitted means count the minibuffer iff
  1073. it is active.  MINIBUF neither t nor nil means not to count the
  1074. minibuffer even if it is active.
  1075.  
  1076. Several frames may share a single minibuffer; if the minibuffer
  1077. counts, all windows on all frames that share that minibuffer count
  1078. too.  Therefore, `next-window' can be used to iterate through the
  1079. set of windows even when the minibuffer is on another frame.  If the
  1080. minibuffer does not count, only windows from WINDOW's frame count.
  1081.  
  1082. Optional third arg ALL-FRAMES t means include windows on all frames.
  1083. ALL-FRAMES nil or omitted means cycle within the frames as specified
  1084. above.  ALL-FRAMES = `visible' means include windows on all visible frames.
  1085. ALL-FRAMES = 0 means include windows on all visible and iconified frames.
  1086. If ALL-FRAMES is a frame, restrict search to windows on that frame.
  1087. Anything else means restrict to WINDOW's frame.
  1088.  
  1089. If you use consistent values for MINIBUF and ALL-FRAMES, you can use
  1090. `next-window' to iterate through the entire cycle of acceptable
  1091. windows, eventually ending up back at the window you started with.
  1092. `previous-window' traverses the same cycle, in the reverse order.
  1093.  
  1094. (next-window &optional WINDOW MINIBUF ALL-FRAMES)Fprevious-window
  1095. Return the window preceding WINDOW in canonical ordering of windows.
  1096. If omitted, WINDOW defaults to the selected window.
  1097.  
  1098. Optional second arg MINIBUF t means count the minibuffer window even
  1099. if not active.  MINIBUF nil or omitted means count the minibuffer iff
  1100. it is active.  MINIBUF neither t nor nil means not to count the
  1101. minibuffer even if it is active.
  1102.  
  1103. Several frames may share a single minibuffer; if the minibuffer
  1104. counts, all windows on all frames that share that minibuffer count
  1105. too.  Therefore, `previous-window' can be used to iterate through
  1106. the set of windows even when the minibuffer is on another frame.  If
  1107. the minibuffer does not count, only windows from WINDOW's frame count
  1108.  
  1109. Optional third arg ALL-FRAMES t means include windows on all frames.
  1110. ALL-FRAMES nil or omitted means cycle within the frames as specified
  1111. above.  ALL-FRAMES = `visible' means include windows on all visible frames.
  1112. ALL-FRAMES = 0 means include windows on all visible and iconified frames.
  1113. If ALL-FRAMES is a frame, restrict search to windows on that frame.
  1114. Anything else means restrict to WINDOW's frame.
  1115.  
  1116. If you use consistent values for MINIBUF and ALL-FRAMES, you can use
  1117. `previous-window' to iterate through the entire cycle of acceptable
  1118. windows, eventually ending up back at the window you started with.
  1119. `next-window' traverses the same cycle, in the reverse order.
  1120.  
  1121. (previous-window &optional WINDOW MINIBUF ALL-FRAMES)Fother-window
  1122. Select the ARG'th different window on this frame.
  1123. All windows on current frame are arranged in a cyclic order.
  1124. This command selects the window ARG steps away in that order.
  1125. A negative ARG moves in the opposite order.  If the optional second
  1126. argument ALL_FRAMES is non-nil, cycle through all frames.
  1127.  
  1128. (other-window ARG &optional ALL-FRAMES)Fget-lru-window
  1129. Return the window least recently selected or used for display.
  1130. If optional argument FRAME is `visible', search all visible frames.
  1131. If FRAME is 0, search all visible and iconified frames.
  1132. If FRAME is t, search all frames.
  1133. If FRAME is nil, search only the selected frame.
  1134. If FRAME is a frame, search only that frame.
  1135.  
  1136. (get-lru-window &optional FRAME)Fget-largest-window
  1137. Return the largest window in area.
  1138. If optional argument FRAME is `visible', search all visible frames.
  1139. If FRAME is 0, search all visible and iconified frames.
  1140. If FRAME is t, search all frames.
  1141. If FRAME is nil, search only the selected frame.
  1142. If FRAME is a frame, search only that frame.
  1143.  
  1144. (get-largest-window &optional FRAME)Fget-buffer-window
  1145. Return a window currently displaying BUFFER, or nil if none.
  1146. If optional argument FRAME is `visible', search all visible frames.
  1147. If optional argument FRAME is 0, search all visible and iconified frames.
  1148. If FRAME is t, search all frames.
  1149. If FRAME is nil, search only the selected frame.
  1150. If FRAME is a frame, search only that frame.
  1151.  
  1152. (get-buffer-window BUFFER &optional FRAME)Fdelete-other-windows
  1153. Make WINDOW (or the selected window) fill its frame.
  1154. Only the frame WINDOW is on is affected.
  1155. This function tries to reduce display jumps
  1156. by keeping the text previously visible in WINDOW
  1157. in the same place on the frame.  Doing this depends on
  1158. the value of (window-start WINDOW), so if calling this function
  1159. in a program gives strange scrolling, make sure the window-start
  1160. value is reasonable when this function is called.
  1161.  
  1162. (delete-other-windows &optional WINDOW)Fdelete-windows-on
  1163. Delete all windows showing BUFFER.
  1164. Optional second argument FRAME controls which frames are affected.
  1165. If nil or omitted, delete all windows showing BUFFER in any frame.
  1166. If t, delete only windows showing BUFFER in the selected frame.
  1167. If `visible', delete all windows showing BUFFER in any visible frame.
  1168. If a frame, delete only windows showing BUFFER in that frame.
  1169.  
  1170. (delete-windows-on BUFFER &optional FRAME)Freplace-buffer-in-windows
  1171. Replace BUFFER with some other buffer in all windows showing it.
  1172.  
  1173. (replace-buffer-in-windows BUFFER)Fset-window-buffer
  1174. Make WINDOW display BUFFER as its contents.
  1175. BUFFER can be a buffer or buffer name.
  1176.  
  1177. (set-window-buffer WINDOW BUFFER)Fselect-window
  1178. Select WINDOW.  Most editing will apply to WINDOW's buffer.
  1179. The main editor command loop selects the buffer of the selected window
  1180. before each command.
  1181.  
  1182. (select-window WINDOW)Fdisplay-buffer
  1183. Make BUFFER appear in some window but don't select it.
  1184. BUFFER can be a buffer or a buffer name.
  1185. If BUFFER is shown already in some window, just use that one,
  1186. unless the window is the selected window and the optional second
  1187. argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
  1188. If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
  1189. Returns the window displaying BUFFER.
  1190.  
  1191. The variables `special-display-buffer-names', `special-display-regexps',
  1192. `same-window-buffer-names', and `same-window-regexps' customize how certain
  1193. buffer names are handled.
  1194.  
  1195. (display-buffer BUFFER &optional NOT-THIS-WINDOW)Fsplit-window
  1196. Split WINDOW, putting SIZE lines in the first of the pair.
  1197. WINDOW defaults to selected one and SIZE to half its size.
  1198. If optional third arg HORFLAG is non-nil, split side by side
  1199. and put SIZE columns in the first of the pair.
  1200.  
  1201. (split-window &optional WINDOW SIZE HORFLAG)Fenlarge-window
  1202. Make current window ARG lines bigger.
  1203. From program, optional second arg non-nil means grow sideways ARG columns.
  1204.  
  1205. (enlarge-window ARG &optional SIDE)Fshrink-window
  1206. Make current window ARG lines smaller.
  1207. From program, optional second arg non-nil means shrink sideways arg columns.
  1208.  
  1209. (shrink-window ARG &optional SIDE)Fscroll-up
  1210. Scroll text of current window upward ARG lines; or near full screen if no ARG.
  1211. A near full screen is `next-screen-context-lines' less than a full screen.
  1212. Negative ARG means scroll downward.
  1213. When calling from a program, supply a number as argument or nil.
  1214.  
  1215. (scroll-up &optional ARG)Fscroll-down
  1216. Scroll text of current window downward ARG lines; or near full screen if no ARG.
  1217. A near full screen is `next-screen-context-lines' less than a full screen.
  1218. Negative ARG means scroll upward.
  1219. When calling from a program, supply a number as argument or nil.
  1220.  
  1221. (scroll-down &optional ARG)Fother-window-for-scrolling
  1222. Return the other window for "other window scroll" commands.
  1223. If in the minibuffer, `minibuffer-scroll-window' if non-nil
  1224. specifies the window.
  1225. If `other-window-scroll-buffer' is non-nil, a window
  1226. showing that buffer is used.
  1227.  
  1228. (other-window-for-scrolling)Fscroll-other-window
  1229. Scroll next window upward ARG lines; or near full screen if no ARG.
  1230. The next window is the one below the current one; or the one at the top
  1231. if the current one is at the bottom.  Negative ARG means scroll downward.
  1232. When calling from a program, supply a number as argument or nil.
  1233.  
  1234. If in the minibuffer, `minibuffer-scroll-window' if non-nil
  1235. specifies the window to scroll.
  1236. If `other-window-scroll-buffer' is non-nil, scroll the window
  1237. showing that buffer, popping the buffer up if necessary.
  1238.  
  1239. (scroll-other-window &optional ARG)Fscroll-left
  1240. Scroll selected window display ARG columns left.
  1241. Default for ARG is window width minus 2.
  1242.  
  1243. (scroll-left &optional ARG)Fscroll-right
  1244. Scroll selected window display ARG columns right.
  1245. Default for ARG is window width minus 2.
  1246.  
  1247. (scroll-right &optional ARG)Frecenter
  1248. Center point in window and redisplay frame.  With ARG, put point on line ARG.
  1249. The desired position of point is always relative to the current window.
  1250. Just C-u as prefix means put point in the center of the window.
  1251. If ARG is omitted or nil, erases the entire frame and then
  1252. redraws with point in the center of the current window.
  1253.  
  1254. (recenter &optional ARG)Fmove-to-window-line
  1255. Position point relative to window.
  1256. With no argument, position point at center of window.
  1257. An argument specifies frame line; zero means top of window,
  1258. negative means relative to bottom of window.
  1259.  
  1260. (move-to-window-line ARG)Fwindow-configuration-p
  1261. T if OBJECT is a window-configuration object.
  1262.  
  1263. (window-configuration-p OBJECT)Fset-window-configuration
  1264. Set the configuration of windows and buffers as specified by CONFIGURATION.
  1265. CONFIGURATION must be a value previously returned
  1266. by `current-window-configuration' (which see).
  1267.  
  1268. (set-window-configuration CONFIGURATION)Fcurrent-window-configuration
  1269. Return an object representing the current window configuration of FRAME.
  1270. If FRAME is nil or omitted, use the selected frame.
  1271. This describes the number of windows, their sizes and current buffers,
  1272. and for each displayed buffer, where display starts, and the positions of
  1273. point and mark.  An exception is made for point in the current buffer:
  1274. its value is -not- saved.
  1275. This also records the currently selected frame, and FRAME's focus
  1276. redirection (see `redirect-frame-focus').
  1277.  
  1278. (current-window-configuration &optional FRAME)Fsave-window-excursion
  1279. Execute body, preserving window sizes and contents.
  1280. Restore which buffer appears in which window, where display starts,
  1281. and the value of point and mark for each window.
  1282. Also restore which buffer is current.
  1283. But do not preserve point in the current buffer.
  1284. Does not restore the value of point in current buffer.Vtemp-buffer-show-function
  1285. Non-nil means call as function to display a help buffer.
  1286. The function is called with one argument, the buffer to be displayed.
  1287. Used by `with-output-to-temp-buffer'.
  1288. If this function is used, then it must do the entire job of showing
  1289. the buffer; `temp-buffer-show-hook' is not run unless this function runs it.Vdisplay-buffer-function
  1290. If non-nil, function to call to handle `display-buffer'.
  1291. It will receive two args, the buffer and a flag which if non-nil means
  1292.  that the currently selected window is not acceptable.
  1293. Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
  1294. work using this function.Vminibuffer-scroll-window
  1295. Non-nil means it is the window that C-M-v in minibuffer should scroll.Vother-window-scroll-buffer
  1296. If non-nil, this is a buffer and \[scroll-other-window] should scroll its window.Vpop-up-frames
  1297. *Non-nil means `display-buffer' should make a separate frame.Vpop-up-frame-function
  1298. Function to call to handle automatic new frame creation.
  1299. It is called with no arguments and should return a newly created frame.
  1300.  
  1301. A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
  1302. where `pop-up-frame-alist' would hold the default frame parameters.Vspecial-display-buffer-names
  1303. *List of buffer names that should have their own special frames.
  1304. Displaying a buffer whose name is in this list makes a special frame for it
  1305. using `special-display-function'.
  1306.  
  1307. An element of the list can be a cons cell instead of just a string.
  1308. Then the car should be a buffer name, and the cdr specifies frame
  1309. parameters for creating the frame for that buffer.
  1310. More precisely, the cdr is passed as the second argument to
  1311. the function found in `special-display-function', when making that frame.
  1312. See also `special-display-regexps'.Vspecial-display-regexps
  1313. *List of regexps saying which buffers should have their own special frames.
  1314. If a buffer name matches one of these regexps, it gets its own frame.
  1315. Displaying a buffer whose name is in this list makes a special frame for it
  1316. using `special-display-function'.
  1317.  
  1318. An element of the list can be a cons cell instead of just a string.
  1319. Then the car should be the regexp, and the cdr specifies frame
  1320. parameters for creating the frame for buffers that match.
  1321. More precisely, the cdr is passed as the second argument to
  1322. the function found in `special-display-function', when making that frame.
  1323. See also `special-display-buffer-names'.Vspecial-display-function
  1324. Function to call to make a new frame for a special buffer.
  1325. It is called with two arguments, the buffer and optional buffer specific
  1326. data, and should return a window displaying that buffer.
  1327. The default value makes a separate frame for the buffer,
  1328. using `special-display-frame-alist' to specify the frame parameters.
  1329.  
  1330. A buffer is special if its is listed in `special-display-buffer-names'
  1331. or matches a regexp in `special-display-regexps'.Vsame-window-buffer-names
  1332. *List of buffer names that should appear in the selected window.
  1333. Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
  1334. switches to it in the selected window, rather than making it appear
  1335. in some other window.
  1336.  
  1337. An element of the list can be a cons cell instead of just a string.
  1338. Then the car must be a string, which specifies the buffer name.
  1339. This is for compatibility with `special-display-buffer-names';
  1340. the cdr of the cons cell is ignored.
  1341.  
  1342. See also `same-window-regexps'.Vsame-window-regexps
  1343. *List of regexps saying which buffers should appear in the selected window.
  1344. If a buffer name matches one of these regexps, then displaying it
  1345. using `display-buffer' or `pop-to-buffer' switches to it
  1346. in the selected window, rather than making it appear in some other window.
  1347.  
  1348. An element of the list can be a cons cell instead of just a string.
  1349. Then the car must be a string, which specifies the buffer name.
  1350. This is for compatibility with `special-display-buffer-names';
  1351. the cdr of the cons cell is ignored.
  1352.  
  1353. See also `same-window-buffer-names'.Vpop-up-windows
  1354. *Non-nil means display-buffer should make new windows.Vnext-screen-context-lines
  1355. *Number of lines of continuity when scrolling by screenfuls.Vsplit-height-threshold
  1356. *display-buffer would prefer to split the largest window if this large.
  1357. If there is only one window, it is split regardless of this value.Vwindow-min-height
  1358. *Delete any window less than this tall (including its mode line).Vwindow-min-width
  1359. *Delete any window less than this wide.Vsystem-uses-terminfo
  1360. Non-nil means the system uses terminfo rather than termcap.
  1361. This variable can be used by terminal emulator packages.Finvocation-name
  1362. Return the program name that was used to run Emacs.
  1363. Any directory names are omitted.
  1364.  
  1365. (invocation-name)Finvocation-directory
  1366. Return the directory name in which the Emacs executable was located
  1367.  
  1368. (invocation-directory)Fkill-emacs
  1369. Exit the Emacs job and kill it.
  1370. If ARG is an integer, return ARG as the exit program code.
  1371. If ARG is a  string, stuff it as keyboard input.
  1372.  
  1373. The value of `kill-emacs-hook', if not void,
  1374. is a list of functions (of no args),
  1375. all of which are called before Emacs is actually killed.
  1376.  
  1377. (kill-emacs &optional ARG)Fdump-emacs-data
  1378. Dump current state of Emacs into data file FILENAME.
  1379. This function exists on systems that use HAVE_SHM.
  1380.  
  1381. (dump-emacs-data FILENAME)Fdump-emacs
  1382. Dump current state of Emacs into executable file FILENAME.
  1383. Take symbols from SYMFILE (presumably the file you executed to run Emacs).
  1384. This is used in the file `loadup.el' when building Emacs.
  1385.  
  1386. Bind `command-line-processed' to nil before dumping,
  1387. if you want the dumped Emacs to process its command line
  1388. and announce itself normally when it is run.
  1389.  
  1390. (dump-emacs FILENAME SYMFILE)Vcommand-line-args
  1391. Args passed by shell to Emacs, as a list of strings.Vsystem-type
  1392. Value is symbol indicating type of operating system you are using.Vsystem-configuration
  1393. Value is string indicating configuration Emacs was built for.Vsystem-configuration-options
  1394. String containing the configuration options Emacs was built with.Vnoninteractive
  1395. Non-nil means Emacs is running without interactive terminal.Vkill-emacs-hook
  1396. Hook to be run whenever kill-emacs is called.
  1397. Since kill-emacs may be invoked when the terminal is disconnected (or
  1398. in other similar situations), functions placed on this hook should not
  1399. expect to be able to interact with the user.  To ask for confirmation,
  1400. see `kill-emacs-query-functions' instead.Vemacs-priority
  1401. Priority for Emacs to run at.
  1402. This value is effective only if set before Emacs is dumped,
  1403. and only if the Emacs executable is installed with setuid to permit
  1404. it to change priority.  (Emacs sets its uid back to the real uid.)
  1405. Currently, you need to define SET_EMACS_PRIORITY in `config.h'
  1406. before you compile Emacs, to enable the code for this feature.Vinvocation-name
  1407. The program name that was used to run Emacs.
  1408. Any directory names are omitted.Vinvocation-directory
  1409. The directory in which the Emacs executable was found, to run it.
  1410. The value is nil if that directory's name is not known.Vinstallation-directory
  1411. A directory within which to look for the `lib-src' and `etc' directories.
  1412. This is non-nil when we can't find those directories in their standard
  1413. installed locations, but we can find them
  1414. near where the Emacs executable was found.Frecursive-edit
  1415. Invoke the editor command loop recursively.
  1416. To get out of the recursive edit, a command can do `(throw 'exit nil)';
  1417. that tells this function to return.
  1418. Alternately, `(throw 'exit t)' makes this function signal an error.
  1419. This function is called by the editor initialization to begin editing.
  1420.  
  1421. (recursive-edit)Ftop-level
  1422. Exit all recursive editing levels.
  1423.  
  1424. (top-level)Fexit-recursive-edit
  1425. Exit from the innermost recursive edit or minibuffer.
  1426.  
  1427. (exit-recursive-edit)Fabort-recursive-edit
  1428. Abort the command that requested this recursive edit or minibuffer input.
  1429.  
  1430. (abort-recursive-edit)Ftrack-mouse
  1431. Evaluate BODY with mouse movement events enabled.
  1432. Within a `track-mouse' form, mouse motion generates input events that
  1433. you can read with `read-event'.
  1434. Normally, mouse motion is ignored.Fevent-convert-list
  1435. Convert the event description list EVENT-DESC to an event type.
  1436. EVENT-DESC should contain one base event type (a character or symbol)
  1437. and zero or more modifier names (control, meta, hyper, super, shift, alt,
  1438. drag, down, double or triple).  The base must be last.
  1439. The return value is an event type (a character or symbol) which
  1440. has the same base event type and all the specified modifiers.
  1441.  
  1442. (event-convert-list EVENT-DESC)Fread-key-sequence
  1443. Read a sequence of keystrokes and return as a string or vector.
  1444. The sequence is sufficient to specify a non-prefix command in the
  1445. current local and global maps.
  1446.  
  1447. First arg PROMPT is a prompt string.  If nil, do not prompt specially.
  1448. Second (optional) arg CONTINUE-ECHO, if non-nil, means this key echos
  1449. as a continuation of the previous key.
  1450.  
  1451. The third (optional) arg DONT-DOWNCASE-LAST, if non-nil, means do not
  1452. convert the last event to lower case.  (Normally any upper case event
  1453. is converted to lower case if the original event is undefined and the lower
  1454. case equivalent is defined.)  A non-nil value is appropriate for reading
  1455. a key sequence to be defined.
  1456.  
  1457. A C-g typed while in this function is treated like any other character,
  1458. and `quit-flag' is not set.
  1459.  
  1460. If the key sequence starts with a mouse click, then the sequence is read
  1461. using the keymaps of the buffer of the window clicked in, not the buffer
  1462. of the selected window as normal.
  1463.  
  1464. `read-key-sequence' drops unbound button-down events, since you normally
  1465. only care about the click or drag events which follow them.  If a drag
  1466. or multi-click event is unbound, but the corresponding click event would
  1467. be bound, `read-key-sequence' turns the event into a click event at the
  1468. drag's starting position.  This means that you don't have to distinguish
  1469. between click and drag, double, or triple events unless you want to.
  1470.  
  1471. `read-key-sequence' prefixes mouse events on mode lines, the vertical
  1472. lines separating windows, and scroll bars with imaginary keys
  1473. `mode-line', `vertical-line', and `vertical-scroll-bar'.
  1474.  
  1475. Optional fourth argument CAN-RETURN-SWITCH-FRAME non-nil means that this
  1476. function will process a switch-frame event if the user switches frames
  1477. before typing anything.  If the user switches frames in the middle of a
  1478. key sequence, or at the start of the sequence but CAN-RETURN-SWITCH-FRAME
  1479. is nil, then the event will be put off until after the current key sequence.
  1480.  
  1481. `read-key-sequence' checks `function-key-map' for function key
  1482. sequences, where they wouldn't conflict with ordinary bindings.  See
  1483. `function-key-map' for more details.
  1484.  
  1485. (read-key-sequence PROMPT &optional CONTINUE-ECHO DONT-DOWNCASE-LAST CAN-RETURN-SWITCH-FRAME)Fcommand-execute
  1486. Execute CMD as an editor command.
  1487. CMD must be a symbol that satisfies the `commandp' predicate.
  1488. Optional second arg RECORD-FLAG non-nil
  1489. means unconditionally put this command in `command-history'.
  1490. Otherwise, that is done only if an arg is read using the minibuffer.
  1491. The argument KEYS specifies the value to use instead of (this-command-keys)
  1492. when reading the arguments; if it is nil, (this-command-keys) is used.
  1493. The argument SPECIAL, if non-nil, means that this command is executing
  1494. a special event, so ignore the prefix argument and don't clear it.
  1495.  
  1496. (command-execute CMD &optional RECORD-FLAG KEYS SPECIAL)Fexecute-extended-command
  1497. Read function name, then read its arguments and call it.
  1498.  
  1499. (execute-extended-command PREFIXARG)Finput-pending-p
  1500. T if command input is currently available with no waiting.
  1501. Actually, the value is nil only if we can be sure that no input is available.
  1502.  
  1503. (input-pending-p)Frecent-keys
  1504. Return vector of last 100 events, not counting those from keyboard macros.
  1505.  
  1506. (recent-keys)Fthis-command-keys
  1507. Return the key sequence that invoked this command.
  1508. The value is a string or a vector.
  1509.  
  1510. (this-command-keys)Fthis-single-command-keys
  1511. Return the key sequence that invoked this command.
  1512. Unlike `this-command-keys', this function's value
  1513. does not include prefix arguments.
  1514. The value is a string or a vector.
  1515.  
  1516. (this-single-command-keys)Freset-this-command-lengths
  1517. Used for complicated reasons in `universal-argument-other-key'.
  1518.  
  1519. `universal-argument-other-key' rereads the event just typed.
  1520. It then gets translated through `function-key-map'.
  1521. The translated event gets included in the echo area and in
  1522. the value of `this-command-keys' in addition to the raw original event.
  1523. That is not right.
  1524.  
  1525. Calling this function directs the translated event to replace
  1526. the original event, so that only one version of the event actually
  1527. appears in the echo area and in the value of `this-command-keys.'.
  1528.  
  1529. (reset-this-command-lengths)Frecursion-depth
  1530. Return the current depth in recursive edits.
  1531.  
  1532. (recursion-depth)Fopen-dribble-file
  1533. Start writing all keyboard characters to a dribble file called FILE.
  1534. If FILE is nil, close any open dribble file.
  1535.  
  1536. (open-dribble-file FILE)Fdiscard-input
  1537. Discard the contents of the terminal input buffer.
  1538. Also cancel any kbd macro being defined.
  1539.  
  1540. (discard-input)Fsuspend-emacs
  1541. Stop Emacs and return to superior process.  You can resume later.
  1542. If `cannot-suspend' is non-nil, or if the system doesn't support job
  1543. control, run a subshell instead.
  1544.  
  1545. If optional arg STUFFSTRING is non-nil, its characters are stuffed
  1546. to be read as terminal input by Emacs's parent, after suspension.
  1547.  
  1548. Before suspending, run the normal hook `suspend-hook'.
  1549. After resumption run the normal hook `suspend-resume-hook'.
  1550.  
  1551. Some operating systems cannot stop the Emacs process and resume it later.
  1552. On such systems, Emacs starts a subshell instead of suspending.
  1553.  
  1554. (suspend-emacs &optional STUFFSTRING)Fset-input-mode
  1555. Set mode of reading keyboard input.
  1556. First arg INTERRUPT non-nil means use input interrupts;
  1557.  nil means use CBREAK mode.
  1558. Second arg FLOW non-nil means use ^S/^Q flow control for output to terminal
  1559.  (no effect except in CBREAK mode).
  1560. Third arg META t means accept 8-bit input (for a Meta key).
  1561.  META nil means ignore the top bit, on the assumption it is parity.
  1562.  Otherwise, accept 8-bit input and don't use the top bit for Meta.
  1563. Optional fourth arg QUIT if non-nil specifies character to use for quitting.
  1564. See also `current-input-mode'.
  1565.  
  1566. (set-input-mode INTERRUPT FLOW META &optional QUIT)Fcurrent-input-mode
  1567. Return information about the way Emacs currently reads keyboard input.
  1568. The value is a list of the form (INTERRUPT FLOW META QUIT), where
  1569.   INTERRUPT is non-nil if Emacs is using interrupt-driven input; if
  1570.     nil, Emacs is using CBREAK mode.
  1571.   FLOW is non-nil if Emacs uses ^S/^Q flow control for output to the
  1572.     terminal; this does not apply if Emacs uses interrupt-driven input.
  1573.   META is t if accepting 8-bit input with 8th bit as Meta flag.
  1574.     META nil means ignoring the top bit, on the assumption it is parity.
  1575.     META is neither t nor nil if accepting 8-bit input and using
  1576.     all 8 bits as the character code.
  1577.   QUIT is the character Emacs currently uses to quit.
  1578. The elements of this list correspond to the arguments of
  1579. `set-input-mode'.
  1580.  
  1581. (current-input-mode)Vlast-command-char
  1582. Last input event that was part of a command.Vlast-command-event
  1583. Last input event that was part of a command.Vlast-nonmenu-event
  1584. Last input event in a command, except for mouse menu events.
  1585. Mouse menus give back keys that don't look like mouse events;
  1586. this variable holds the actual mouse event that led to the menu,
  1587. so that you can determine whether the command was run by mouse or not.Vlast-input-char
  1588. Last input event.Vlast-input-event
  1589. Last input event.Vunread-command-events
  1590. List of objects to be read as next command input events.Vunread-command-char
  1591. If not -1, an object to be read as next command input event.Vmeta-prefix-char
  1592. Meta-prefix character code.  Meta-foo as command input
  1593. turns into this character followed by foo.Vlast-command
  1594. The last command executed.  Normally a symbol with a function definition,
  1595. but can be whatever was found in the keymap, or whatever the variable
  1596. `this-command' was set to by that command.
  1597.  
  1598. The value `mode-exit' is special; it means that the previous command
  1599. read an event that told it to exit, and it did so and unread that event.
  1600. In other words, the present command is the event that made the previous
  1601. command exit.
  1602.  
  1603. The value `kill-region' is special; it means that the previous command
  1604. was a kill command.Vthis-command
  1605. The command now being executed.
  1606. The command can set this variable; whatever is put here
  1607. will be in `last-command' during the following command.Vauto-save-interval
  1608. *Number of keyboard input characters between auto-saves.
  1609. Zero means disable autosaving due to number of characters typed.Vauto-save-timeout
  1610. *Number of seconds idle time before auto-save.
  1611. Zero or nil means disable auto-saving due to idleness.
  1612. After auto-saving due to this many seconds of idle time,
  1613. Emacs also does a garbage collection if that seems to be warranted.Vecho-keystrokes
  1614. *Nonzero means echo unfinished commands after this many seconds of pause.Vpolling-period
  1615. *Interval between polling for input during Lisp execution.
  1616. The reason for polling is to make C-g work to stop a running program.
  1617. Polling is needed only when using X windows and SIGIO does not work.
  1618. Polling is automatically disabled in all other cases.Vdouble-click-time
  1619. *Maximum time between mouse clicks to make a double-click.
  1620. Measured in milliseconds.  nil means disable double-click recognition;
  1621. t means double-clicks have no time limit and are detected
  1622. by position only.Vinhibit-local-menu-bar-menus
  1623. *Non-nil means inhibit local map menu bar menus.Vnum-input-keys
  1624. Number of complete keys read from the keyboard so far.Vlast-event-frame
  1625. The frame in which the most recently read event occurred.
  1626. If the last event came from a keyboard macro, this is set to `macro'.Vhelp-char
  1627. Character to recognize as meaning Help.
  1628. When it is read, do `(eval help-form)', and display result if it's a string.
  1629. If the value of `help-form' is nil, this char can be read normally.Vhelp-event-list
  1630. List of input events to recognize as meaning Help.
  1631. These work just like the value of `help-char' (see that).Vhelp-form
  1632. Form to execute when character `help-char' is read.
  1633. If the form returns a string, that string is displayed.
  1634. If `help-form' is nil, the help char is not recognized.Vprefix-help-command
  1635. Command to run when `help-char' character follows a prefix key.
  1636. This command is used only when there is no actual binding
  1637. for that character after that prefix key.Vtop-level
  1638. Form to evaluate when Emacs starts up.
  1639. Useful to set before you dump a modified Emacs.Vkeyboard-translate-table
  1640. Translate table for keyboard input, or nil.
  1641. Each character is looked up in this string and the contents used instead.
  1642. The value may be a string, a vector, or a char-table.
  1643. If it is a string or vector of length N,
  1644. character codes N and up are untranslated.
  1645. In a vector or a char-table, an element which is nil means "no translation".Vcannot-suspend
  1646. Non-nil means to always spawn a subshell instead of suspending,
  1647. even if the operating system has support for stopping a process.Vmenu-prompting
  1648. Non-nil means prompt with menus when appropriate.
  1649. This is done when reading from a keymap that has a prompt string,
  1650. for elements that have prompt strings.
  1651. The menu is displayed on the screen
  1652. if X menus were enabled at configuration
  1653. time and the previous event was a mouse click prefix key.
  1654. Otherwise, menu prompting uses the echo area.Vmenu-prompt-more-char
  1655. Character to see next line of menu prompt.
  1656. Type this character while in a menu prompt to rotate around the lines of it.Vextra-keyboard-modifiers
  1657. A mask of additional modifier keys to use with every keyboard character.
  1658. Emacs applies the modifiers of the character stored here to each keyboard
  1659. character it reads.  For example, after evaluating the expression
  1660.     (setq extra-keyboard-modifiers ?\C-x)
  1661. all input characters will have the control modifier applied to them.
  1662.  
  1663. Note that the character ?\C-@, equivalent to the integer zero, does
  1664. not count as a control character; rather, it counts as a character
  1665. with no modifiers; thus, setting `extra-keyboard-modifiers' to zero
  1666. cancels any modification.Vdeactivate-mark
  1667. If an editing command sets this to t, deactivate the mark afterward.
  1668. The command loop sets this to nil before each command,
  1669. and tests the value when the command returns.
  1670. Buffer modification stores t in this variable.Vcommand-hook-internal
  1671. Temporary storage of pre-command-hook or post-command-hook.Vpre-command-hook
  1672. Normal hook run before each command is executed.
  1673. Errors running the hook are caught and ignored.Vpost-command-hook
  1674. Normal hook run after each command is executed.
  1675. Errors running the hook are caught and ignored.Vpost-command-idle-hook
  1676. Normal hook run after each command is executed, if idle.
  1677. Errors running the hook are caught and ignored.
  1678. This feature is obsolete; use idle timers instead.  See `etc/NEWS'.Vpost-command-idle-delay
  1679. Delay time before running `post-command-idle-hook'.
  1680. This is measured in microseconds.Vlucid-menu-bar-dirty-flag
  1681. t means menu bar, specified Lucid style, needs to be recomputed.Vmenu-bar-final-items
  1682. List of menu bar items to move to the end of the menu bar.
  1683. The elements of the list are event types that may have menu bar bindings.Voverriding-terminal-local-map
  1684. Keymap that overrides all other local keymaps.
  1685. If this variable is non-nil, it is used as a keymap instead of the
  1686. buffer's local map, and the minor mode keymaps and text property keymaps.Voverriding-local-map
  1687. Keymap that overrides all other local keymaps.
  1688. If this variable is non-nil, it is used as a keymap instead of the
  1689. buffer's local map, and the minor mode keymaps and text property keymaps.Voverriding-local-map-menu-flag
  1690. Non-nil means `overriding-local-map' applies to the menu bar.
  1691. Otherwise, the menu bar continues to reflect the buffer's local map
  1692. and the minor mode maps regardless of `overriding-local-map'.Vspecial-event-map
  1693. Keymap defining bindings for special events to execute at low level.Vtrack-mouse
  1694. *Non-nil means generate motion events for mouse motion.Vsystem-key-alist
  1695. Alist of system-specific X windows key symbols.
  1696. Each element should have the form (N . SYMBOL) where N is the
  1697. numeric keysym code (sans the "system-specific" bit 1<<28)
  1698. and SYMBOL is its name.Vdeferred-action-list
  1699. List of deferred actions to be performed at a later time.
  1700. The precise format isn't relevant here; we just check whether it is nil.Vdeferred-action-function
  1701. Function to call to handle deferred actions, after each command.
  1702. This function is called with no arguments after each command
  1703. whenever `deferred-action-list' is non-nil.Vsuggest-key-bindings
  1704. Non-nil means show the equivalent key-binding when M-x command has one.
  1705. The value can be a length of time to show the message for.
  1706. If the value is non-nil and not a number, we wait 2 seconds.Vcolumn-number-mode
  1707. Non-nil enables display of the current column number in the mode line.Vtimer-list
  1708. List of active absolute time timers in order of increasing timeVtimer-idle-list
  1709. List of active idle-time timers in order of increasing timeFstart-kbd-macro
  1710. Record subsequent keyboard input, defining a keyboard macro.
  1711. The commands are recorded even as they are executed.
  1712. Use \[end-kbd-macro] to finish recording and make the macro available.
  1713. Use \[name-last-kbd-macro] to give it a permanent name.
  1714. Non-nil arg (prefix arg) means append to last macro defined;
  1715.  This begins by re-executing that macro as if you typed it again.
  1716.  
  1717. (start-kbd-macro APPEND)Fend-kbd-macro
  1718. Finish defining a keyboard macro.
  1719. The definition was started by \[start-kbd-macro].
  1720. The macro is now available for use via \[call-last-kbd-macro],
  1721. or it can be given a name with \[name-last-kbd-macro] and then invoked
  1722. under that name.
  1723.  
  1724. With numeric arg, repeat macro now that many times,
  1725. counting the definition just completed as the first repetition.
  1726. An argument of zero means repeat until error.
  1727.  
  1728. (end-kbd-macro &optional REPEAT)Fcancel-kbd-macro-events
  1729. Cancel the events added to a keyboard macro for this command.
  1730.  
  1731. (cancel-kbd-macro-events)Fstore-kbd-macro-event
  1732. Store EVENT into the keyboard macro being defined.
  1733.  
  1734. (store-kbd-macro-event EVENT)Fcall-last-kbd-macro
  1735. Call the last keyboard macro that you defined with \[start-kbd-macro].
  1736.  
  1737. A prefix argument serves as a repeat count.  Zero means repeat until error.
  1738.  
  1739. To make a macro permanent so you can call it even after
  1740. defining others, use \[name-last-kbd-macro].
  1741.  
  1742. (call-last-kbd-macro &optional PREFIX)Fexecute-kbd-macro
  1743. Execute MACRO as string of editor command characters.
  1744. If MACRO is a symbol, its function definition is used.
  1745. COUNT is a repeat count, or nil for once, or 0 for infinite loop.
  1746.  
  1747. (execute-kbd-macro MACRO &optional COUNT)Vdefining-kbd-macro
  1748. Non-nil while a keyboard macro is being defined.  Don't set this!Vexecuting-macro
  1749. Currently executing keyboard macro (string or vector); nil if none executing.Vexecuting-kbd-macro
  1750. Currently executing keyboard macro (string or vector); nil if none executing.Vlast-kbd-macro
  1751. Last kbd macro defined, as a string or vector; nil if none defined.Fmake-keymap
  1752. Construct and return a new keymap, of the form (keymap VECTOR . ALIST).
  1753. VECTOR is a vector which holds the bindings for the ASCII
  1754. characters.  ALIST is an assoc-list which holds bindings for function keys,
  1755. mouse events, and any other things that appear in the input stream.
  1756. All entries in it are initially nil, meaning "command undefined".
  1757.  
  1758. The optional arg STRING supplies a menu name for the keymap
  1759. in case you use it as a menu with `x-popup-menu'.
  1760.  
  1761. (make-keymap &optional STRING)Fmake-sparse-keymap
  1762. Construct and return a new sparse-keymap list.
  1763. Its car is `keymap' and its cdr is an alist of (CHAR . DEFINITION),
  1764. which binds the character CHAR to DEFINITION, or (SYMBOL . DEFINITION),
  1765. which binds the function key or mouse event SYMBOL to DEFINITION.
  1766. Initially the alist is nil.
  1767.  
  1768. The optional arg STRING supplies a menu name for the keymap
  1769. in case you use it as a menu with `x-popup-menu'.
  1770.  
  1771. (make-sparse-keymap &optional STRING)Fkeymapp
  1772. Return t if OBJECT is a keymap.
  1773.  
  1774. A keymap is a list (keymap . ALIST),
  1775. or a symbol whose function definition is itself a keymap.
  1776. ALIST elements look like (CHAR . DEFN) or (SYMBOL . DEFN);
  1777. a vector of densely packed bindings for small character codes
  1778. is also allowed as an element.
  1779.  
  1780. (keymapp OBJECT)Fkeymap-parent
  1781. Return the parent keymap of KEYMAP.
  1782.  
  1783. (keymap-parent KEYMAP)Fset-keymap-parent
  1784. Modify KEYMAP to set its parent map to PARENT.
  1785. PARENT should be nil or another keymap.
  1786.  
  1787. (set-keymap-parent KEYMAP PARENT)Fcopy-keymap
  1788. Return a copy of the keymap KEYMAP.
  1789. The copy starts out with the same definitions of KEYMAP,
  1790. but changing either the copy or KEYMAP does not affect the other.
  1791. Any key definitions that are subkeymaps are recursively copied.
  1792. However, a key definition which is a symbol whose definition is a keymap
  1793. is not copied.
  1794.  
  1795. (copy-keymap KEYMAP)Fdefine-key
  1796. Args KEYMAP, KEY, DEF.  Define key sequence KEY, in KEYMAP, as DEF.
  1797. KEYMAP is a keymap.  KEY is a string or a vector of symbols and characters
  1798. meaning a sequence of keystrokes and events.
  1799. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  1800. can be included if you use a vector.
  1801. DEF is anything that can be a key's definition:
  1802.  nil (means key is undefined in this keymap),
  1803.  a command (a Lisp function suitable for interactive calling)
  1804.  a string (treated as a keyboard macro),
  1805.  a keymap (to define a prefix key),
  1806.  a symbol.  When the key is looked up, the symbol will stand for its
  1807.     function definition, which should at that time be one of the above,
  1808.     or another symbol whose function definition is used, etc.
  1809.  a cons (STRING . DEFN), meaning that DEFN is the definition
  1810.     (DEFN should be a valid definition in its own right),
  1811.  or a cons (KEYMAP . CHAR), meaning use definition of CHAR in map KEYMAP.
  1812.  
  1813. If KEYMAP is a sparse keymap, the pair binding KEY to DEF is added at
  1814. the front of KEYMAP.
  1815.  
  1816. (define-key KEYMAP KEY DEF)Flookup-key
  1817. In keymap KEYMAP, look up key sequence KEY.  Return the definition.
  1818. nil means undefined.  See doc of `define-key' for kinds of definitions.
  1819.  
  1820. A number as value means KEY is "too long";
  1821. that is, characters or symbols in it except for the last one
  1822. fail to be a valid sequence of prefix characters in KEYMAP.
  1823. The number is how many characters at the front of KEY
  1824. it takes to reach a non-prefix command.
  1825.  
  1826. Normally, `lookup-key' ignores bindings for t, which act as default
  1827. bindings, used when nothing else in the keymap applies; this makes it
  1828. usable as a general function for probing keymaps.  However, if the
  1829. third optional argument ACCEPT-DEFAULT is non-nil, `lookup-key' will
  1830. recognize the default bindings, just as `read-key-sequence' does.
  1831.  
  1832. (lookup-key KEYMAP KEY &optional ACCEPT-DEFAULT)Fkey-binding
  1833. Return the binding for command KEY in current keymaps.
  1834. KEY is a string or vector, a sequence of keystrokes.
  1835. The binding is probably a symbol with a function definition.
  1836.  
  1837. Normally, `key-binding' ignores bindings for t, which act as default
  1838. bindings, used when nothing else in the keymap applies; this makes it
  1839. usable as a general function for probing keymaps.  However, if the
  1840. optional second argument ACCEPT-DEFAULT is non-nil, `key-binding' does
  1841. recognize the default bindings, just as `read-key-sequence' does.
  1842.  
  1843. (key-binding KEY &optional ACCEPT-DEFAULT)Flocal-key-binding
  1844. Return the binding for command KEYS in current local keymap only.
  1845. KEYS is a string, a sequence of keystrokes.
  1846. The binding is probably a symbol with a function definition.
  1847.  
  1848. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1849. bindings; see the description of `lookup-key' for more details about this.
  1850.  
  1851. (local-key-binding KEYS &optional ACCEPT-DEFAULT)Fglobal-key-binding
  1852. Return the binding for command KEYS in current global keymap only.
  1853. KEYS is a string, a sequence of keystrokes.
  1854. The binding is probably a symbol with a function definition.
  1855. This function's return values are the same as those of lookup-key
  1856. (which see).
  1857.  
  1858. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1859. bindings; see the description of `lookup-key' for more details about this.
  1860.  
  1861. (global-key-binding KEYS &optional ACCEPT-DEFAULT)Fminor-mode-key-binding
  1862. Find the visible minor mode bindings of KEY.
  1863. Return an alist of pairs (MODENAME . BINDING), where MODENAME is the
  1864. the symbol which names the minor mode binding KEY, and BINDING is
  1865. KEY's definition in that mode.  In particular, if KEY has no
  1866. minor-mode bindings, return nil.  If the first binding is a
  1867. non-prefix, all subsequent bindings will be omitted, since they would
  1868. be ignored.  Similarly, the list doesn't include non-prefix bindings
  1869. that come after prefix bindings.
  1870.  
  1871. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1872. bindings; see the description of `lookup-key' for more details about this.
  1873.  
  1874. (minor-mode-key-binding KEY &optional ACCEPT-DEFAULT)Fdefine-prefix-command
  1875. Define COMMAND as a prefix command.  COMMAND should be a symbol.
  1876. A new sparse keymap is stored as COMMAND's function definition and its value.
  1877. If a second optional argument MAPVAR is given, the map is stored as
  1878. its value instead of as COMMAND's value; but COMMAND is still defined
  1879. as a function.
  1880.  
  1881. (define-prefix-command COMMAND &optional MAPVAR)Fuse-global-map
  1882. Select KEYMAP as the global keymap.
  1883.  
  1884. (use-global-map KEYMAP)Fuse-local-map
  1885. Select KEYMAP as the local keymap.
  1886. If KEYMAP is nil, that means no local keymap.
  1887.  
  1888. (use-local-map KEYMAP)Fcurrent-local-map
  1889. Return current buffer's local keymap, or nil if it has none.
  1890.  
  1891. (current-local-map)Fcurrent-global-map
  1892. Return the current global keymap.
  1893.  
  1894. (current-global-map)Fcurrent-minor-mode-maps
  1895. Return a list of keymaps for the minor modes of the current buffer.
  1896.  
  1897. (current-minor-mode-maps)Faccessible-keymaps
  1898. Find all keymaps accessible via prefix characters from KEYMAP.
  1899. Returns a list of elements of the form (KEYS . MAP), where the sequence
  1900. KEYS starting from KEYMAP gets you to MAP.  These elements are ordered
  1901. so that the KEYS increase in length.  The first element is ([] . KEYMAP).
  1902. An optional argument PREFIX, if non-nil, should be a key sequence;
  1903. then the value includes only maps for prefixes that start with PREFIX.
  1904.  
  1905. (accessible-keymaps KEYMAP &optional PREFIX)Fkey-description
  1906. Return a pretty description of key-sequence KEYS.
  1907. Control characters turn into "C-foo" sequences, meta into "M-foo"
  1908. spaces are put between sequence elements, etc.
  1909.  
  1910. (key-description KEYS)Fsingle-key-description
  1911. Return a pretty description of command character KEY.
  1912. Control characters turn into C-whatever, etc.
  1913.  
  1914. (single-key-description KEY)Ftext-char-description
  1915. Return a pretty description of file-character CHARACTER.
  1916. Control characters turn into "^char", etc.
  1917.  
  1918. (text-char-description CHARACTER)Fwhere-is-internal
  1919. Return list of keys that invoke DEFINITION.
  1920. If KEYMAP is non-nil, search only KEYMAP and the global keymap.
  1921. If KEYMAP is nil, search all the currently active keymaps.
  1922.  
  1923. If optional 3rd arg FIRSTONLY is non-nil, return the first key sequence found,
  1924. rather than a list of all possible key sequences.
  1925. If FIRSTONLY is the symbol `non-ascii', return the first binding found,
  1926. no matter what it is.
  1927. If FIRSTONLY has another non-nil value, prefer sequences of ASCII characters,
  1928. and entirely reject menu bindings.
  1929.  
  1930. If optional 4th arg NOINDIRECT is non-nil, don't follow indirections
  1931. to other keymaps or slots.  This makes it possible to search for an
  1932. indirect definition itself.
  1933.  
  1934. (where-is-internal DEFINITION &optional KEYMAP FIRSTONLY NOINDIRECT)Fdescribe-bindings
  1935. Show a list of all defined keys, and their definitions.
  1936. The list is put in a buffer, which is displayed.
  1937. An optional argument PREFIX, if non-nil, should be a key sequence;
  1938. then we display only bindings that start with that prefix.
  1939.  
  1940. (describe-bindings &optional PREFIX)Fdescribe-vector
  1941. Insert a description of contents of VECTOR.
  1942. This is text showing the elements of vector matched against indices.
  1943.  
  1944. (describe-vector VECTOR)Fapropos-internal
  1945. Show all symbols whose names contain match for REGEXP.
  1946. If optional 2nd arg PREDICATE is non-nil, (funcall PREDICATE SYMBOL) is done
  1947. for each symbol and a symbol is mentioned only if that returns non-nil.
  1948. Return list of symbols found.
  1949.  
  1950. (apropos-internal REGEXP &optional PREDICATE)Vdefine-key-rebound-commands
  1951. List of commands given new key bindings recently.
  1952. This is used for internal purposes during Emacs startup;
  1953. don't alter it yourself.Vminibuffer-local-map
  1954. Default keymap to use when reading from the minibuffer.Vminibuffer-local-ns-map
  1955. Local keymap for the minibuffer when spaces are not allowed.Vminibuffer-local-completion-map
  1956. Local keymap for minibuffer input with completion.Vminibuffer-local-must-match-map
  1957. Local keymap for minibuffer input with completion, for exact match.Vminor-mode-map-alist
  1958. Alist of keymaps to use for minor modes.
  1959. Each element looks like (VARIABLE . KEYMAP); KEYMAP is used to read
  1960. key sequences and look up bindings iff VARIABLE's value is non-nil.
  1961. If two active keymaps bind the same key, the keymap appearing earlier
  1962. in the list takes precedence.Vfunction-key-map
  1963. Keymap mapping ASCII function key sequences onto their preferred forms.
  1964. This allows Emacs to recognize function keys sent from ASCII
  1965. terminals at any point in a key sequence.
  1966.  
  1967. The `read-key-sequence' function replaces any subsequence bound by
  1968. `function-key-map' with its binding.  More precisely, when the active
  1969. keymaps have no binding for the current key sequence but
  1970. `function-key-map' binds a suffix of the sequence to a vector or string,
  1971. `read-key-sequence' replaces the matching suffix with its binding, and
  1972. continues with the new sequence.
  1973.  
  1974. The events that come from bindings in `function-key-map' are not
  1975. themselves looked up in `function-key-map'.
  1976.  
  1977. For example, suppose `function-key-map' binds `ESC O P' to [f1].
  1978. Typing `ESC O P' to `read-key-sequence' would return [f1].  Typing
  1979. `C-x ESC O P' would return [?\C-x f1].  If [f1] were a prefix
  1980. key, typing `ESC O P x' would return [f1 x].Vkey-translation-map
  1981. Keymap of key translations that can override keymaps.
  1982. This keymap works like `function-key-map', but comes after that,
  1983. and applies even for keys that have ordinary bindings.Fbuffer-live-p
  1984. Return non-nil if OBJECT is a buffer which has not been killed.
  1985. Value is nil if OBJECT is not a buffer or if it has been killed.
  1986.  
  1987. (buffer-live-p OBJECT)Fbuffer-list
  1988. Return a list of all existing live buffers.
  1989.  
  1990. (buffer-list)Fget-buffer
  1991. Return the buffer named NAME (a string).
  1992. If there is no live buffer named NAME, return nil.
  1993. NAME may also be a buffer; if so, the value is that buffer.
  1994.  
  1995. (get-buffer NAME)Fget-file-buffer
  1996. Return the buffer visiting file FILENAME (a string).
  1997. The buffer's `buffer-file-name' must match exactly the expansion of FILENAME.
  1998. If there is no such live buffer, return nil.
  1999. See also `find-buffer-visiting'.
  2000.  
  2001. (get-file-buffer FILENAME)Fget-buffer-create
  2002. Return the buffer named NAME, or create such a buffer and return it.
  2003. A new buffer is created if there is no live buffer named NAME.
  2004. If NAME starts with a space, the new buffer does not keep undo information.
  2005. If NAME is a buffer instead of a string, then it is the value returned.
  2006. The value is never nil.
  2007.  
  2008. (get-buffer-create NAME)Fmake-indirect-buffer
  2009. Create and return an indirect buffer for buffer BASE-BUFFER, named NAME.
  2010. BASE-BUFFER should be an existing buffer (or buffer name).
  2011. NAME should be a string which is not the name of an existing buffer.
  2012.  
  2013. (make-indirect-buffer BASE-BUFFER NAME)Fgenerate-new-buffer-name
  2014. Return a string that is the name of no existing buffer based on NAME.
  2015. If there is no live buffer named NAME, then return NAME.
  2016. Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
  2017. until an unused name is found, and then return that name.
  2018. Optional second argument IGNORE specifies a name that is okay to use
  2019. (if it is in the sequence to be tried)
  2020. even if a buffer with that name exists.
  2021.  
  2022. (generate-new-buffer-name NAME &optional IGNORE)Fbuffer-name
  2023. Return the name of BUFFER, as a string.
  2024. With no argument or nil as argument, return the name of the current buffer.
  2025.  
  2026. (buffer-name &optional BUFFER)Fbuffer-file-name
  2027. Return name of file BUFFER is visiting, or nil if none.
  2028. No argument or nil as argument means use the current buffer.
  2029.  
  2030. (buffer-file-name &optional BUFFER)Fbuffer-base-buffer
  2031. Return the base buffer of indirect buffer BUFFER.
  2032. If BUFFER is not indirect, return nil.
  2033.  
  2034. (buffer-base-buffer &optional BUFFER)Fbuffer-local-variables
  2035. Return an alist of variables that are buffer-local in BUFFER.
  2036. Most elements look like (SYMBOL . VALUE), describing one variable.
  2037. For a symbol that is locally unbound, just the symbol appears in the value.
  2038. Note that storing new VALUEs in these elements doesn't change the variables.
  2039. No argument or nil as argument means use current buffer as BUFFER.
  2040.  
  2041. (buffer-local-variables &optional BUFFER)Fbuffer-modified-p
  2042. Return t if BUFFER was modified since its file was last read or saved.
  2043. No argument or nil as argument means use current buffer as BUFFER.
  2044.  
  2045. (buffer-modified-p &optional BUFFER)Fset-buffer-modified-p
  2046. Mark current buffer as modified or unmodified according to FLAG.
  2047. A non-nil FLAG means mark the buffer modified.
  2048.  
  2049. (set-buffer-modified-p FLAG)Fbuffer-modified-tick
  2050. Return BUFFER's tick counter, incremented for each change in text.
  2051. Each buffer has a tick counter which is incremented each time the text in
  2052. that buffer is changed.  It wraps around occasionally.
  2053. No argument or nil as argument means use current buffer as BUFFER.
  2054.  
  2055. (buffer-modified-tick &optional BUFFER)Frename-buffer
  2056. Change current buffer's name to NEWNAME (a string).
  2057. If second arg UNIQUE is nil or omitted, it is an error if a
  2058. buffer named NEWNAME already exists.
  2059. If UNIQUE is non-nil, come up with a new name using
  2060. `generate-new-buffer-name'.
  2061. Interactively, you can set UNIQUE with a prefix argument.
  2062. We return the name we actually gave the buffer.
  2063. This does not change the name of the visited file (if any).
  2064.  
  2065. (rename-buffer NEWNAME &optional UNIQUE)Fother-buffer
  2066. Return most recently selected buffer other than BUFFER.
  2067. Buffers not visible in windows are preferred to visible buffers,
  2068. unless optional second argument VISIBLE-OK is non-nil.
  2069. If no other buffer exists, the buffer `*scratch*' is returned.
  2070. If BUFFER is omitted or nil, some interesting buffer is returned.
  2071.  
  2072. (other-buffer &optional BUFFER VISIBLE-OK)Fbuffer-disable-undo
  2073. Make BUFFER stop keeping undo information.
  2074. No argument or nil as argument means do this for the current buffer.
  2075.  
  2076. (buffer-disable-undo &optional BUFFER)Fbuffer-enable-undo
  2077. Start keeping undo information for buffer BUFFER.
  2078. No argument or nil as argument means do this for the current buffer.
  2079.  
  2080. (buffer-enable-undo &optional BUFFER)Vkill-buffer-hook
  2081. Hook to be run (by `run-hooks', which see) when a buffer is killed.
  2082. The buffer being killed will be current while the hook is running.
  2083. See `kill-buffer'.Fkill-buffer
  2084. Kill the buffer BUFFER.
  2085. The argument may be a buffer or may be the name of a buffer.
  2086. An argument of nil means kill the current buffer.
  2087.  
  2088. Value is t if the buffer is actually killed, nil if user says no.
  2089.  
  2090. The value of `kill-buffer-hook' (which may be local to that buffer),
  2091. if not void, is a list of functions to be called, with no arguments,
  2092. before the buffer is actually killed.  The buffer to be killed is current
  2093. when the hook functions are called.
  2094.  
  2095. Any processes that have this buffer as the `process-buffer' are killed
  2096. with SIGHUP.
  2097.  
  2098. (kill-buffer BUFFER)Fset-buffer-major-mode
  2099. Set an appropriate major mode for BUFFER, according to `default-major-mode'.
  2100. Use this function before selecting the buffer, since it may need to inspect
  2101. the current buffer's major mode.
  2102.  
  2103. (set-buffer-major-mode BUFFER)Fswitch-to-buffer
  2104. Select buffer BUFFER in the current window.
  2105. BUFFER may be a buffer or a buffer name.
  2106. Optional second arg NORECORD non-nil means
  2107. do not put this buffer at the front of the list of recently selected ones.
  2108.  
  2109. WARNING: This is NOT the way to work on another buffer temporarily
  2110. within a Lisp program!  Use `set-buffer' instead.  That avoids messing with
  2111. the window-buffer correspondences.
  2112.  
  2113. (switch-to-buffer BUFFER &optional NORECORD)Fpop-to-buffer
  2114. Select buffer BUFFER in some window, preferably a different one.
  2115. If BUFFER is nil, then some other buffer is chosen.
  2116. If `pop-up-windows' is non-nil, windows can be split to do this.
  2117. If optional second arg OTHER-WINDOW is non-nil, insist on finding another
  2118. window even if BUFFER is already visible in the selected window.
  2119. This uses the function `display-buffer' as a subroutine; see the documentation
  2120. of `display-buffer' for additional customization information.
  2121.  
  2122. (pop-to-buffer BUFFER &optional OTHER-WINDOW)Fcurrent-buffer
  2123. Return the current buffer as a Lisp object.
  2124.  
  2125. (current-buffer)Fset-buffer
  2126. Make the buffer BUFFER current for editing operations.
  2127. BUFFER may be a buffer or the name of an existing buffer.
  2128. See also `save-excursion' when you want to make a buffer current temporarily.
  2129. This function does not display the buffer, so its effect ends
  2130. when the current command terminates.
  2131. Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.
  2132.  
  2133. (set-buffer BUFFER)Fbarf-if-buffer-read-only
  2134. Signal a `buffer-read-only' error if the current buffer is read-only.
  2135.  
  2136. (barf-if-buffer-read-only)Fbury-buffer
  2137. Put BUFFER at the end of the list of all buffers.
  2138. There it is the least likely candidate for `other-buffer' to return;
  2139. thus, the least likely buffer for \[switch-to-buffer] to select by default.
  2140. If BUFFER is nil or omitted, bury the current buffer.
  2141. Also, if BUFFER is nil or omitted, remove the current buffer from the
  2142. selected window if it is displayed there.
  2143.  
  2144. (bury-buffer &optional BUFFER)Ferase-buffer
  2145. Delete the entire contents of the current buffer.
  2146. Any narrowing restriction in effect (see `narrow-to-region') is removed,
  2147. so the buffer is truly empty after this.
  2148.  
  2149. (erase-buffer)Fkill-all-local-variables
  2150. Switch to Fundamental mode by killing current buffer's local variables.
  2151. Most local variable bindings are eliminated so that the default values
  2152. become effective once more.  Also, the syntax table is set from
  2153. `standard-syntax-table', the local keymap is set to nil,
  2154. and the abbrev table from `fundamental-mode-abbrev-table'.
  2155. This function also forces redisplay of the mode line.
  2156.  
  2157. Every function to select a new major mode starts by
  2158. calling this function.
  2159.  
  2160. As a special exception, local variables whose names have
  2161. a non-nil `permanent-local' property are not eliminated by this function.
  2162.  
  2163. The first thing this function does is run
  2164. the normal hook `change-major-mode-hook'.
  2165.  
  2166. (kill-all-local-variables)Foverlayp
  2167. Return t if OBJECT is an overlay.
  2168.  
  2169. (overlayp OBJECT)Fmake-overlay
  2170. Create a new overlay with range BEG to END in BUFFER.
  2171. If omitted, BUFFER defaults to the current buffer.
  2172. BEG and END may be integers or markers.
  2173. The fourth arg FRONT-ADVANCE, if non-nil, makes the
  2174. front delimiter advance when text is inserted there.
  2175. The fifth arg REAR-ADVANCE, if non-nil, makes the
  2176. rear delimiter advance when text is inserted there.
  2177.  
  2178. (make-overlay BEG END &optional BUFFER FRONT-ADVANCE REAR-ADVANCE)Fmove-overlay
  2179. Set the endpoints of OVERLAY to BEG and END in BUFFER.
  2180. If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
  2181. If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
  2182. buffer.
  2183.  
  2184. (move-overlay OVERLAY BEG END &optional BUFFER)Fdelete-overlay
  2185. Delete the overlay OVERLAY from its buffer.
  2186.  
  2187. (delete-overlay OVERLAY)Foverlay-start
  2188. Return the position at which OVERLAY starts.
  2189.  
  2190. (overlay-start OVERLAY)Foverlay-end
  2191. Return the position at which OVERLAY ends.
  2192.  
  2193. (overlay-end OVERLAY)Foverlay-buffer
  2194. Return the buffer OVERLAY belongs to.
  2195.  
  2196. (overlay-buffer OVERLAY)Foverlay-properties
  2197. Return a list of the properties on OVERLAY.
  2198. This is a copy of OVERLAY's plist; modifying its conses has no effect on
  2199. OVERLAY.
  2200.  
  2201. (overlay-properties OVERLAY)Foverlays-at
  2202. Return a list of the overlays that contain position POS.
  2203.  
  2204. (overlays-at POS)Foverlays-in
  2205. Return a list of the overlays that overlap the region BEG ... END.
  2206. Overlap means that at least one character is contained within the overlay
  2207. and also contained within the specified region.
  2208. Empty overlays are included in the result if they are located at BEG
  2209. or between BEG and END.
  2210.  
  2211. (overlays-in BEG END)Fnext-overlay-change
  2212. Return the next position after POS where an overlay starts or ends.
  2213. If there are no more overlay boundaries after POS, return (point-max).
  2214.  
  2215. (next-overlay-change POS)Fprevious-overlay-change
  2216. Return the previous position before POS where an overlay starts or ends.
  2217. If there are no more overlay boundaries before POS, return (point-min).
  2218.  
  2219. (previous-overlay-change POS)Foverlay-lists
  2220. Return a pair of lists giving all the overlays of the current buffer.
  2221. The car has all the overlays before the overlay center;
  2222. the cdr has all the overlays after the overlay center.
  2223. Recentering overlays moves overlays between these lists.
  2224. The lists you get are copies, so that changing them has no effect.
  2225. However, the overlays you get are the real objects that the buffer uses.
  2226.  
  2227. (overlay-lists)Foverlay-recenter
  2228. Recenter the overlays of the current buffer around position POS.
  2229.  
  2230. (overlay-recenter POS)Foverlay-get
  2231. Get the property of overlay OVERLAY with property name PROP.
  2232.  
  2233. (overlay-get OVERLAY PROP)Foverlay-put
  2234. Set one property of overlay OVERLAY: give property PROP value VALUE.
  2235.  
  2236. (overlay-put OVERLAY PROP VALUE)Vdefault-mode-line-format
  2237. Default value of `mode-line-format' for buffers that don't override it.
  2238. This is the same as (default-value 'mode-line-format).Vdefault-abbrev-mode
  2239. Default value of `abbrev-mode' for buffers that do not override it.
  2240. This is the same as (default-value 'abbrev-mode).Vdefault-ctl-arrow
  2241. Default value of `ctl-arrow' for buffers that do not override it.
  2242. This is the same as (default-value 'ctl-arrow).Vdefault-truncate-lines
  2243. Default value of `truncate-lines' for buffers that do not override it.
  2244. This is the same as (default-value 'truncate-lines).Vdefault-fill-column
  2245. Default value of `fill-column' for buffers that do not override it.
  2246. This is the same as (default-value 'fill-column).Vdefault-left-margin
  2247. Default value of `left-margin' for buffers that do not override it.
  2248. This is the same as (default-value 'left-margin).Vdefault-tab-width
  2249. Default value of `tab-width' for buffers that do not override it.
  2250. This is the same as (default-value 'tab-width).Vdefault-case-fold-search
  2251. Default value of `case-fold-search' for buffers that don't override it.
  2252. This is the same as (default-value 'case-fold-search).Vdefault-buffer-file-type
  2253. Default file type for buffers that do not override it.
  2254. This is the same as (default-value 'buffer-file-type).
  2255. The file type is nil for text, t for binary.Vmode-line-format
  2256. Template for displaying mode line for current buffer.
  2257. Each buffer has its own value of this variable.
  2258. Value may be a string, a symbol or a list or cons cell.
  2259. For a symbol, its value is used (but it is ignored if t or nil).
  2260.  A string appearing directly as the value of a symbol is processed verbatim
  2261.  in that the %-constructs below are not recognized.
  2262. For a list whose car is a symbol, the symbol's value is taken,
  2263.  and if that is non-nil, the cadr of the list is processed recursively.
  2264.  Otherwise, the caddr of the list (if there is one) is processed.
  2265. For a list whose car is a string or list, each element is processed
  2266.  recursively and the results are effectively concatenated.
  2267. For a list whose car is an integer, the cdr of the list is processed
  2268.   and padded (if the number is positive) or truncated (if negative)
  2269.   to the width specified by that number.
  2270. A string is printed verbatim in the mode line except for %-constructs:
  2271.   (%-constructs are allowed when the string is the entire mode-line-format
  2272.    or when it is found in a cons-cell or a list)
  2273.   %b -- print buffer name.      %f -- print visited file name.
  2274.   %* -- print %, * or hyphen.   %+ -- print *, % or hyphen.
  2275.     % means buffer is read-only and * means it is modified.
  2276.     For a modified read-only buffer, %* gives % and %+ gives *.
  2277.   %s -- print process status.   %l -- print the current line number.
  2278.   %c -- print the current column number (this makes editing slower).
  2279.   %p -- print percent of buffer above top of window, or Top, Bot or All.
  2280.   %P -- print percent of buffer above bottom of window, perhaps plus Top,
  2281.         or print Bottom or All.
  2282.   %n -- print Narrow if appropriate.
  2283.   %t -- print T if files is text, B if binary.
  2284.   %[ -- print one [ for each recursive editing level.  %] similar.
  2285.   %% -- print %.   %- -- print infinitely many dashes.
  2286. Decimal digits after the % specify field width to which to pad.Vdefault-major-mode
  2287. *Major mode for new buffers.  Defaults to `fundamental-mode'.
  2288. nil here means use current buffer's major mode.Vmajor-mode
  2289. Symbol for current buffer's major mode.Vmode-name
  2290. Pretty name of current buffer's major mode (a string).Vabbrev-mode
  2291. Non-nil turns on automatic expansion of abbrevs as they are inserted.
  2292. Automatically becomes buffer-local when set in any fashion.Vcase-fold-search
  2293. *Non-nil if searches should ignore case.
  2294. Automatically becomes buffer-local when set in any fashion.Vfill-column
  2295. *Column beyond which automatic line-wrapping should happen.
  2296. Automatically becomes buffer-local when set in any fashion.Vleft-margin
  2297. *Column for the default indent-line-function to indent to.
  2298. Linefeed indents to this column in Fundamental mode.
  2299. Automatically becomes buffer-local when set in any fashion.Vtab-width
  2300. *Distance between tab stops (for display of tab characters), in columns.
  2301. Automatically becomes buffer-local when set in any fashion.Vctl-arrow
  2302. *Non-nil means display control chars with uparrow.
  2303. Nil means use backslash and octal digits.
  2304. Automatically becomes buffer-local when set in any fashion.
  2305. This variable does not apply to characters whose display is specified
  2306. in the current display table (if there is one).Vtruncate-lines
  2307. *Non-nil means do not display continuation lines;
  2308. give each line of text one screen line.
  2309. Automatically becomes buffer-local when set in any fashion.
  2310.  
  2311. Note that this is overridden by the variable
  2312. `truncate-partial-width-windows' if that variable is non-nil
  2313. and this buffer is not full-frame width.Vbuffer-file-type
  2314. Non-nil if the visited file is a binary file.
  2315. This variable is meaningful on MS-DOG and Windows NT.
  2316. On those systems, it is automatically local in every buffer.
  2317. On other systems, this variable is normally always nil.Vdefault-directory
  2318. Name of default directory of current buffer.  Should end with slash.
  2319. Each buffer has its own value of this variable.Vauto-fill-function
  2320. Function called (if non-nil) to perform auto-fill.
  2321. It is called after self-inserting a space or newline.
  2322. Each buffer has its own value of this variable.
  2323. NOTE: This variable is not a hook;
  2324. its value may not be a list of functions.Vbuffer-file-name
  2325. Name of file visited in current buffer, or nil if not visiting a file.
  2326. Each buffer has its own value of this variable.Vbuffer-file-truename
  2327. Abbreviated truename of file visited in current buffer, or nil if none.
  2328. The truename of a file is calculated by `file-truename'
  2329. and then abbreviated with `abbreviate-file-name'.
  2330. Each buffer has its own value of this variable.Vbuffer-auto-save-file-name
  2331. Name of file for auto-saving current buffer,
  2332. or nil if buffer should not be auto-saved.
  2333. Each buffer has its own value of this variable.Vbuffer-read-only
  2334. Non-nil if this buffer is read-only.
  2335. Each buffer has its own value of this variable.Vbuffer-backed-up
  2336. Non-nil if this buffer's file has been backed up.
  2337. Backing up is done before the first time the file is saved.
  2338. Each buffer has its own value of this variable.Vbuffer-saved-size
  2339. Length of current buffer when last read in, saved or auto-saved.
  2340. 0 initially.
  2341. Each buffer has its own value of this variable.Vselective-display
  2342. Non-nil enables selective display:
  2343. Integer N as value means display only lines
  2344.  that start with less than n columns of space.
  2345. A value of t means, after a ^M, all the rest of the line is invisible.
  2346.  Then ^M's in the file are written into files as newlines.
  2347.  
  2348. Automatically becomes buffer-local when set in any fashion.Vselective-display-ellipses
  2349. t means display ... on previous line when a line is invisible.
  2350. Automatically becomes buffer-local when set in any fashion.Voverwrite-mode
  2351. Non-nil if self-insertion should replace existing text.
  2352. The value should be one of `overwrite-mode-textual',
  2353. `overwrite-mode-binary', or nil.
  2354. If it is `overwrite-mode-textual', self-insertion still
  2355. inserts at the end of a line, and inserts when point is before a tab,
  2356. until the tab is filled in.
  2357. If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.
  2358. Automatically becomes buffer-local when set in any fashion.Vbuffer-display-table
  2359. Display table that controls display of the contents of current buffer.
  2360. Automatically becomes buffer-local when set in any fashion.
  2361. The display table is a char-table created with `make-display-table'.
  2362. The ordinary char-table elements control how to display each possible text
  2363. character.  Each value should be a vector of characters or nil;
  2364. nil means display the character in the default fashion.
  2365. There are six extra slots to control the display of
  2366.   the end of a truncated screen line (extra-slot 0, a single character);
  2367.   the end of a continued line (extra-slot 1, a single character);
  2368.   the escape character used to display character codes in octal
  2369.     (extra-slot 2, a single character);
  2370.   the character used as an arrow for control characters (extra-slot 3,
  2371.     a single character);
  2372.   the decoration indicating the presence of invisible lines (extra-slot 4,
  2373.     a vector of characters);
  2374.   the character used to draw the border between side-by-side windows
  2375.     (extra-slot 5, a single character).
  2376. See also the functions `display-table-slot' and `set-display-table-slot'.
  2377. If this variable is nil, the value of `standard-display-table' is used.
  2378. Each window can have its own, overriding display table.Vbefore-change-function
  2379. Function to call before each text change.
  2380. Two arguments are passed to the function: the positions of
  2381. the beginning and end of the range of old text to be changed.
  2382. (For an insertion, the beginning and end are at the same place.)
  2383. No information is given about the length of the text after the change.
  2384.  
  2385. Buffer changes made while executing the `before-change-function'
  2386. don't call any before-change or after-change functions.
  2387. That's because these variables are temporarily set to nil.
  2388. As a result, a hook function cannot straightforwardly alter the value of
  2389. these variables.  See the Emacs Lisp manual for a way of
  2390. accomplishing an equivalent result by using other variables.Vafter-change-function
  2391. Function to call after each text change.
  2392. Three arguments are passed to the function: the positions of
  2393. the beginning and end of the range of changed text,
  2394. and the length of the pre-change text replaced by that range.
  2395. (For an insertion, the pre-change length is zero;
  2396. for a deletion, that length is the number of characters deleted,
  2397. and the post-change beginning and end are at the same place.)
  2398.  
  2399. Buffer changes made while executing the `after-change-function'
  2400. don't call any before-change or after-change functions.
  2401. That's because these variables are temporarily set to nil.
  2402. As a result, a hook function cannot straightforwardly alter the value of
  2403. these variables.  See the Emacs Lisp manual for a way of
  2404. accomplishing an equivalent result by using other variables.Vbefore-change-functions
  2405. List of functions to call before each text change.
  2406. Two arguments are passed to each function: the positions of
  2407. the beginning and end of the range of old text to be changed.
  2408. (For an insertion, the beginning and end are at the same place.)
  2409. No information is given about the length of the text after the change.
  2410.  
  2411. Buffer changes made while executing the `before-change-functions'
  2412. don't call any before-change or after-change functions.
  2413. That's because these variables are temporarily set to nil.
  2414. As a result, a hook function cannot straightforwardly alter the value of
  2415. these variables.  See the Emacs Lisp manual for a way of
  2416. accomplishing an equivalent result by using other variables.Vafter-change-functions
  2417. List of function to call after each text change.
  2418. Three arguments are passed to each function: the positions of
  2419. the beginning and end of the range of changed text,
  2420. and the length of the pre-change text replaced by that range.
  2421. (For an insertion, the pre-change length is zero;
  2422. for a deletion, that length is the number of characters deleted,
  2423. and the post-change beginning and end are at the same place.)
  2424.  
  2425. Buffer changes made while executing the `after-change-functions'
  2426. don't call any before-change or after-change functions.
  2427. That's because these variables are temporarily set to nil.
  2428. As a result, a hook function cannot straightforwardly alter the value of
  2429. these variables.  See the Emacs Lisp manual for a way of
  2430. accomplishing an equivalent result by using other variables.Vfirst-change-hook
  2431. A list of functions to call before changing a buffer which is unmodified.
  2432. The functions are run using the `run-hooks' function.Vbuffer-undo-list
  2433. List of undo entries in current buffer.
  2434. Recent changes come first; older changes follow newer.
  2435.  
  2436. An entry (BEG . END) represents an insertion which begins at
  2437. position BEG and ends at position END.
  2438.  
  2439. An entry (TEXT . POSITION) represents the deletion of the string TEXT
  2440. from (abs POSITION).  If POSITION is positive, point was at the front
  2441. of the text being deleted; if negative, point was at the end.
  2442.  
  2443. An entry (t HIGH . LOW) indicates that the buffer previously had
  2444. "unmodified" status.  HIGH and LOW are the high and low 16-bit portions
  2445. of the visited file's modification time, as of that time.  If the
  2446. modification time of the most recent save is different, this entry is
  2447. obsolete.
  2448.  
  2449. An entry (nil PROPERTY VALUE BEG . END) indicates that a text property
  2450. was modified between BEG and END.  PROPERTY is the property name,
  2451. and VALUE is the old value.
  2452.  
  2453. An entry (MARKER . DISTANCE) indicates that the marker MARKER
  2454. was adjusted in position by the offset DISTANCE (an integer).
  2455.  
  2456. An entry of the form POSITION indicates that point was at the buffer
  2457. location given by the integer.  Undoing an entry of this form places
  2458. point at POSITION.
  2459.  
  2460. nil marks undo boundaries.  The undo command treats the changes
  2461. between two undo boundaries as a single step to be undone.
  2462.  
  2463. If the value of the variable is t, undo information is not recorded.Vmark-active
  2464. Non-nil means the mark and region are currently active in this buffer.
  2465. Automatically local in all buffers.Vcache-long-line-scans
  2466. Non-nil means that Emacs should use caches to handle long lines more quickly.
  2467. This variable is buffer-local, in all buffers.
  2468.  
  2469. Normally, the line-motion functions work by scanning the buffer for
  2470. newlines.  Columnar operations (like move-to-column and
  2471. compute-motion) also work by scanning the buffer, summing character
  2472. widths as they go.  This works well for ordinary text, but if the
  2473. buffer's lines are very long (say, more than 500 characters), these
  2474. motion functions will take longer to execute.  Emacs may also take
  2475. longer to update the display.
  2476.  
  2477. If cache-long-line-scans is non-nil, these motion functions cache the
  2478. results of their scans, and consult the cache to avoid rescanning
  2479. regions of the buffer until the text is modified.  The caches are most
  2480. beneficial when they prevent the most searching---that is, when the
  2481. buffer contains long lines and large regions of characters with the
  2482. same, fixed screen width.
  2483.  
  2484. When cache-long-line-scans is non-nil, processing short lines will
  2485. become slightly slower (because of the overhead of consulting the
  2486. cache), and the caches will use memory roughly proportional to the
  2487. number of newlines and characters whose screen width varies.
  2488.  
  2489. The caches require no explicit maintenance; their accuracy is
  2490. maintained internally by the Emacs primitives.  Enabling or disabling
  2491. the cache should not affect the behavior of any of the motion
  2492. functions; it should only affect their performance.Vpoint-before-scroll
  2493. Value of point before the last series of scroll operations, or nil.Vbuffer-file-format
  2494. List of formats to use when saving this buffer.
  2495. Formats are defined by `format-alist'.  This variable is
  2496. set when a file is visited.  Automatically local in all buffers.Vbuffer-invisibility-spec
  2497. Invisibility spec of this buffer.
  2498. The default is t, which means that text is invisible
  2499. if it has a non-nil `invisible' property.
  2500. If the value is a list, a text character is invisible if its `invisible'
  2501. property is an element in that list.
  2502. If an element is a cons cell of the form (PROP . ELLIPSIS),
  2503. then characters with property value PROP are invisible,
  2504. and they have an ellipsis as well if ELLIPSIS is non-nil.Vtransient-mark-mode
  2505. *Non-nil means deactivate the mark when the buffer contents change.Vinhibit-read-only
  2506. *Non-nil means disregard read-only status of buffers or characters.
  2507. If the value is t, disregard `buffer-read-only' and all `read-only'
  2508. text properties.  If the value is a list, disregard `buffer-read-only'
  2509. and disregard a `read-only' text property if the property value
  2510. is a member of the list.Vkill-buffer-query-functions
  2511. List of functions called with no args to query before killing a buffer.Vemx-binary-mode
  2512. *Non-nil means read and write files in `binary mode'.
  2513. nil means use `text mode'.  This variable is emx-specific.
  2514. Automatically becomes buffer-local when set in any fashion.Vextended-attributes
  2515. Extended attributes of buffer visited by current buffer.
  2516. This variable is emx-specific.  Automatically becomes buffer-local
  2517. when set in any fashion.Flock-buffer
  2518. Lock FILE, if current buffer is modified.
  2519. FILE defaults to current buffer's visited file,
  2520. or else nothing is done if current buffer isn't visiting a file.
  2521.  
  2522. (lock-buffer &optional FILE)Funlock-buffer
  2523. Unlock the file visited in the current buffer,
  2524. if it should normally be locked.
  2525.  
  2526. (unlock-buffer)Ffile-locked-p
  2527. Return nil if the FILENAME is not locked,
  2528. t if it is locked by you, else a string of the name of the locker.
  2529.  
  2530. (file-locked-p &optional FILENAME)Fmarker-buffer
  2531. Return the buffer that MARKER points into, or nil if none.
  2532. Returns nil if MARKER points into a dead buffer.
  2533.  
  2534. (marker-buffer MARKER)Fmarker-position
  2535. Return the position MARKER points at, as a character number.
  2536.  
  2537. (marker-position MARKER)Fset-marker
  2538. Position MARKER before character number POSITION in BUFFER.
  2539. BUFFER defaults to the current buffer.
  2540. If POSITION is nil, makes marker point nowhere.
  2541. Then it no longer slows down editing in any buffer.
  2542. Returns MARKER.
  2543.  
  2544. (set-marker MARKER POSITION &optional BUFFER)Fcopy-marker
  2545. Return a new marker pointing at the same place as MARKER.
  2546. If argument is a number, makes a new marker pointing
  2547. at that position in the current buffer.
  2548. The optional argument TYPE specifies the insertion type of the new marker;
  2549. see `marker-insertion-type'.
  2550.  
  2551. (copy-marker MARKER &optional TYPE)Fmarker-insertion-type
  2552. Return insertion type of MARKER: t if it stays after inserted text.
  2553. nil means the marker stays before text inserted there.
  2554.  
  2555. (marker-insertion-type MARKER)Fset-marker-insertion-type
  2556. Set the insertion-type of MARKER to TYPE.
  2557. If TYPE is t, it means the marker advances when you insert text at it.
  2558. If TYPE is nil, it means the marker stays behind when you insert text at it.
  2559.  
  2560. (set-marker-insertion-type MARKER TYPE)Fset-minibuffer-window
  2561. Specify which minibuffer window to use for the minibuffer.
  2562. This effects where the minibuffer is displayed if you put text in it
  2563. without invoking the usual minibuffer commands.
  2564.  
  2565. (set-minibuffer-window WINDOW)Fread-from-minibuffer
  2566. Read a string from the minibuffer, prompting with string PROMPT.
  2567. If optional second arg INITIAL-CONTENTS is non-nil, it is a string
  2568.   to be inserted into the minibuffer before reading input.
  2569.   If INITIAL-CONTENTS is (STRING . POSITION), the initial input
  2570.   is STRING, but point is placed at position POSITION in the minibuffer.
  2571. Third arg KEYMAP is a keymap to use whilst reading;
  2572.   if omitted or nil, the default is `minibuffer-local-map'.
  2573. If fourth arg READ is non-nil, then interpret the result as a lisp object
  2574.   and return that object:
  2575.   in other words, do `(car (read-from-string INPUT-STRING))'
  2576. Fifth arg HIST, if non-nil, specifies a history list
  2577.   and optionally the initial position in the list.
  2578.   It can be a symbol, which is the history list variable to use,
  2579.   or it can be a cons cell (HISTVAR . HISTPOS).
  2580.   In that case, HISTVAR is the history list variable to use,
  2581.   and HISTPOS is the initial position (the position in the list
  2582.   which INITIAL-CONTENTS corresponds to).
  2583.   Positions are counted starting from 1 at the beginning of the list.
  2584.  
  2585. (read-from-minibuffer PROMPT &optional INITIAL-CONTENTS KEYMAP READ HIST)Fread-minibuffer
  2586. Return a Lisp object read using the minibuffer.
  2587. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  2588. is a string to insert in the minibuffer before reading.
  2589.  
  2590. (read-minibuffer PROMPT &optional INITIAL-CONTENTS)Feval-minibuffer
  2591. Return value of Lisp expression read using the minibuffer.
  2592. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  2593. is a string to insert in the minibuffer before reading.
  2594.  
  2595. (eval-minibuffer PROMPT &optional INITIAL-CONTENTS)Fread-string
  2596. Read a string from the minibuffer, prompting with string PROMPT.
  2597. If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
  2598. The third arg HISTORY, if non-nil, specifies a history list
  2599.   and optionally the initial position in the list.
  2600. See `read-from-minibuffer' for details of HISTORY argument.
  2601.  
  2602. (read-string PROMPT &optional INITIAL-INPUT HISTORY)Fread-no-blanks-input
  2603. Args PROMPT and INIT, strings.  Read a string from the terminal, not allowing blanks.
  2604. Prompt with PROMPT, and provide INIT as an initial value of the input string.
  2605.  
  2606. (read-no-blanks-input PROMPT &optional INIT)Fread-command
  2607. One arg PROMPT, a string.  Read the name of a command and return as a symbol.
  2608. Prompts with PROMPT.
  2609.  
  2610. (read-command PROMPT)Fread-function
  2611. One arg PROMPT, a string.  Read the name of a function and return as a symbol.
  2612. Prompts with PROMPT.
  2613.  
  2614. (read-function PROMPT)Fread-variable
  2615. One arg PROMPT, a string.  Read the name of a user variable and return
  2616. it as a symbol.  Prompts with PROMPT.
  2617. A user variable is one whose documentation starts with a `*' character.
  2618.  
  2619. (read-variable PROMPT)Fread-buffer
  2620. One arg PROMPT, a string.  Read the name of a buffer and return as a string.
  2621. Prompts with PROMPT.
  2622. Optional second arg is value to return if user enters an empty line.
  2623. If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.
  2624.  
  2625. (read-buffer PROMPT &optional DEF REQUIRE-MATCH)Ftry-completion
  2626. Return common substring of all completions of STRING in ALIST.
  2627. Each car of each element of ALIST is tested to see if it begins with STRING.
  2628. All that match are compared together; the longest initial sequence
  2629. common to all matches is returned as a string.
  2630. If there is no match at all, nil is returned.
  2631. For an exact match, t is returned.
  2632.  
  2633. ALIST can be an obarray instead of an alist.
  2634. Then the print names of all symbols in the obarray are the possible matches.
  2635.  
  2636. ALIST can also be a function to do the completion itself.
  2637. It receives three arguments: the values STRING, PREDICATE and nil.
  2638. Whatever it returns becomes the value of `try-completion'.
  2639.  
  2640. If optional third argument PREDICATE is non-nil,
  2641. it is used to test each possible match.
  2642. The match is a candidate only if PREDICATE returns non-nil.
  2643. The argument given to PREDICATE is the alist element
  2644. or the symbol from the obarray.
  2645.  
  2646. (try-completion STRING ALIST &optional PREDICATE)Fall-completions
  2647. Search for partial matches to STRING in ALIST.
  2648. Each car of each element of ALIST is tested to see if it begins with STRING.
  2649. The value is a list of all the strings from ALIST that match.
  2650.  
  2651. ALIST can be an obarray instead of an alist.
  2652. Then the print names of all symbols in the obarray are the possible matches.
  2653.  
  2654. ALIST can also be a function to do the completion itself.
  2655. It receives three arguments: the values STRING, PREDICATE and t.
  2656. Whatever it returns becomes the value of `all-completion'.
  2657.  
  2658. If optional third argument PREDICATE is non-nil,
  2659. it is used to test each possible match.
  2660. The match is a candidate only if PREDICATE returns non-nil.
  2661. The argument given to PREDICATE is the alist element
  2662. or the symbol from the obarray.
  2663.  
  2664. If the optional fourth argument HIDE-SPACES is non-nil,
  2665. strings in ALIST that start with a space
  2666. are ignored unless STRING itself starts with a space.
  2667.  
  2668. (all-completions STRING ALIST &optional PREDICATE HIDE-SPACES)Fcompleting-read
  2669. Read a string in the minibuffer, with completion.
  2670. PROMPT is a string to prompt with; normally it ends in a colon and a space.
  2671. TABLE is an alist whose elements' cars are strings, or an obarray.
  2672. PREDICATE limits completion to a subset of TABLE.
  2673. See `try-completion' and `all-completions' for more details
  2674.  on completion, TABLE, and PREDICATE.
  2675.  
  2676. If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
  2677.  the input is (or completes to) an element of TABLE or is null.
  2678.  If it is also not t, Return does not exit if it does non-null completion.
  2679. If the input is null, `completing-read' returns nil,
  2680.  regardless of the value of REQUIRE-MATCH.
  2681.  
  2682. If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.
  2683.   If it is (STRING . POSITION), the initial input
  2684.   is STRING, but point is placed POSITION characters into the string.
  2685. HIST, if non-nil, specifies a history list
  2686.   and optionally the initial position in the list.
  2687.   It can be a symbol, which is the history list variable to use,
  2688.   or it can be a cons cell (HISTVAR . HISTPOS).
  2689.   In that case, HISTVAR is the history list variable to use,
  2690.   and HISTPOS is the initial position (the position in the list
  2691.   which INITIAL-CONTENTS corresponds to).
  2692.   Positions are counted starting from 1 at the beginning of the list.
  2693. Completion ignores case if the ambient value of
  2694.   `completion-ignore-case' is non-nil.
  2695.  
  2696. (completing-read PROMPT TABLE &optional PREDICATE REQUIRE-MATCH INIT HIST)Fminibuffer-complete
  2697. Complete the minibuffer contents as far as possible.
  2698. Return nil if there is no valid completion, else t.
  2699. If no characters can be completed, display a list of possible completions.
  2700. If you repeat this command after it displayed such a list,
  2701. scroll the window of possible completions.
  2702.  
  2703. (minibuffer-complete)Fminibuffer-complete-and-exit
  2704. If the minibuffer contents is a valid completion then exit.
  2705. Otherwise try to complete it.  If completion leads to a valid completion,
  2706. a repetition of this command will exit.
  2707.  
  2708. (minibuffer-complete-and-exit)Fminibuffer-complete-word
  2709. Complete the minibuffer contents at most a single word.
  2710. After one word is completed as much as possible, a space or hyphen
  2711. is added, provided that matches some possible completion.
  2712. Return nil if there is no valid completion, else t.
  2713.  
  2714. (minibuffer-complete-word)Fdisplay-completion-list
  2715. Display the list of completions, COMPLETIONS, using `standard-output'.
  2716. Each element may be just a symbol or string
  2717. or may be a list of two strings to be printed as if concatenated.
  2718. `standard-output' must be a buffer.
  2719. At the end, run the normal hook `completion-setup-hook'.
  2720. It can find the completion buffer in `standard-output'.
  2721.  
  2722. (display-completion-list COMPLETIONS)Fminibuffer-completion-help
  2723. Display a list of possible completions of the current minibuffer contents.
  2724.  
  2725. (minibuffer-completion-help)Fself-insert-and-exit
  2726. Terminate minibuffer input.
  2727.  
  2728. (self-insert-and-exit)Fexit-minibuffer
  2729. Terminate this minibuffer argument.
  2730.  
  2731. (exit-minibuffer)Fminibuffer-depth
  2732. Return current depth of activations of minibuffer, a nonnegative integer.
  2733.  
  2734. (minibuffer-depth)Fminibuffer-prompt
  2735. Return the prompt string of the currently-active minibuffer.
  2736. If no minibuffer is active, return nil.
  2737.  
  2738. (minibuffer-prompt)Fminibuffer-prompt-width
  2739. Return the display width of the minibuffer prompt.
  2740.  
  2741. (minibuffer-prompt-width)Vminibuffer-setup-hook
  2742. Normal hook run just after entry to minibuffer.Vminibuffer-exit-hook
  2743. Normal hook run just after exit from minibuffer.Vcompletion-auto-help
  2744. *Non-nil means automatically provide help for invalid completion input.Vcompletion-ignore-case
  2745. Non-nil means don't consider case significant in completion.Venable-recursive-minibuffers
  2746. *Non-nil means to allow minibuffer commands while in the minibuffer.
  2747. More precisely, this variable makes a difference when the minibuffer window
  2748. is the selected window.  If you are in some other window, minibuffer commands
  2749. are allowed even if a minibuffer is active.Vminibuffer-completion-table
  2750. Alist or obarray used for completion in the minibuffer.
  2751. This becomes the ALIST argument to `try-completion' and `all-completion'.
  2752.  
  2753. The value may alternatively be a function, which is given three arguments:
  2754.   STRING, the current buffer contents;
  2755.   PREDICATE, the predicate for filtering possible matches;
  2756.   CODE, which says what kind of things to do.
  2757. CODE can be nil, t or `lambda'.
  2758. nil means to return the best completion of STRING, or nil if there is none.
  2759. t means to return a list of all possible completions of STRING.
  2760. `lambda' means to return t if STRING is a valid completion as it stands.Vminibuffer-completion-predicate
  2761. Within call to `completing-read', this holds the PREDICATE argument.Vminibuffer-completion-confirm
  2762. Non-nil => demand confirmation of completion before exiting minibuffer.Vminibuffer-help-form
  2763. Value that `help-form' takes on inside the minibuffer.Vminibuffer-history-variable
  2764. History list symbol to add minibuffer values to.
  2765. Each string of minibuffer input, as it appears on exit from the minibuffer,
  2766. is added with
  2767.   (set minibuffer-history-variable
  2768.        (cons STRING (symbol-value minibuffer-history-variable)))Vminibuffer-history-position
  2769. Current position of redoing in the history list.Vminibuffer-auto-raise
  2770. *Non-nil means entering the minibuffer raises the minibuffer's frame.Vcompletion-regexp-list
  2771. List of regexps that should restrict possible completions.Ffind-file-name-handler
  2772. Return FILENAME's handler function for OPERATION, if it has one.
  2773. Otherwise, return nil.
  2774. A file name is handled if one of the regular expressions in
  2775. `file-name-handler-alist' matches it.
  2776.  
  2777. If OPERATION equals `inhibit-file-name-operation', then we ignore
  2778. any handlers that are members of `inhibit-file-name-handlers',
  2779. but we still do run any other handlers.  This lets handlers
  2780. use the standard functions without calling themselves recursively.
  2781.  
  2782. (find-file-name-handler FILENAME OPERATION)Ffile-name-directory
  2783. Return the directory component in file name FILENAME.
  2784. Return nil if FILENAME does not include a directory.
  2785. Otherwise return a directory spec.
  2786. Given a Unix syntax file name, returns a string ending in slash;
  2787. on VMS, perhaps instead a string ending in `:', `]' or `>'.
  2788.  
  2789. (file-name-directory FILENAME)Ffile-name-nondirectory
  2790. Return file name FILENAME sans its directory.
  2791. For example, in a Unix-syntax file name,
  2792. this is everything after the last slash,
  2793. or the entire name if it contains no slash.
  2794.  
  2795. (file-name-nondirectory FILENAME)Funhandled-file-name-directory
  2796. Return a directly usable directory name somehow associated with FILENAME.
  2797. A `directly usable' directory name is one that may be used without the
  2798. intervention of any file handler.
  2799. If FILENAME is a directly usable file itself, return
  2800. (file-name-directory FILENAME).
  2801. The `call-process' and `start-process' functions use this function to
  2802. get a current directory to run processes in.
  2803.  
  2804. (unhandled-file-name-directory FILENAME)Ffile-name-as-directory
  2805. Return a string representing file FILENAME interpreted as a directory.
  2806. This operation exists because a directory is also a file, but its name as
  2807. a directory is different from its name as a file.
  2808. The result can be used as the value of `default-directory'
  2809. or passed as second argument to `expand-file-name'.
  2810. For a Unix-syntax file name, just appends a slash.
  2811. On VMS, converts "[X]FOO.DIR" to "[X.FOO]", etc.
  2812.  
  2813. (file-name-as-directory FILE)Fdirectory-file-name
  2814. Returns the file name of the directory named DIRECTORY.
  2815. This is the name of the file that holds the data for the directory DIRECTORY.
  2816. This operation exists because a directory is also a file, but its name as
  2817. a directory is different from its name as a file.
  2818. In Unix-syntax, this function just removes the final slash.
  2819. On VMS, given a VMS-syntax directory name such as "[X.Y]",
  2820. it returns a file name such as "[X]Y.DIR.1".
  2821.  
  2822. (directory-file-name DIRECTORY)Fmake-temp-name
  2823. Generate temporary file name (string) starting with PREFIX (a string).
  2824. The Emacs process number forms part of the result,
  2825. so there is no danger of generating a name being used by another process.
  2826.  
  2827. (make-temp-name PREFIX)Fexpand-file-name
  2828. Convert filename NAME to absolute, and canonicalize it.
  2829. Second arg DEFAULT-DIRECTORY is directory to start with if NAME is relative
  2830.  (does not start with slash); if DEFAULT-DIRECTORY is nil or missing,
  2831. the current buffer's value of default-directory is used.
  2832. File name components that are `.' are removed, and 
  2833. so are file name components followed by `..', along with the `..' itself;
  2834. note that these simplifications are done without checking the resulting
  2835. file names in the file system.
  2836. An initial `~/' expands to your home directory.
  2837. An initial `~USER/' expands to USER's home directory.
  2838. See also the function `substitute-in-file-name'.
  2839.  
  2840. (expand-file-name NAME &optional DEFAULT-DIRECTORY)Fsubstitute-in-file-name
  2841. Substitute environment variables referred to in FILENAME.
  2842. `$FOO' where FOO is an environment variable name means to substitute
  2843. the value of that variable.  The variable name should be terminated
  2844. with a character not a letter, digit or underscore; otherwise, enclose
  2845. the entire variable name in braces.
  2846. If `/~' appears, all of FILENAME through that `/' is discarded.
  2847.  
  2848. On VMS, `$' substitution is not done; this function does little and only
  2849. duplicates what `expand-file-name' does.
  2850.  
  2851. (substitute-in-file-name FILENAME)Fcopy-file
  2852. Copy FILE to NEWNAME.  Both args must be strings.
  2853. Signals a `file-already-exists' error if file NEWNAME already exists,
  2854. unless a third argument OK-IF-ALREADY-EXISTS is supplied and non-nil.
  2855. A number as third arg means request confirmation if NEWNAME already exists.
  2856. This is what happens in interactive use with M-x.
  2857. Fourth arg KEEP-TIME non-nil means give the new file the same
  2858. last-modified time as the old one.  (This works on only some systems.)
  2859. A prefix arg makes KEEP-TIME non-nil.
  2860.  
  2861. (copy-file FILE NEWNAME &optional OK-IF-ALREADY-EXISTS KEEP-DATE)Fmake-directory-internal
  2862. Create a new directory named DIRECTORY.
  2863.  
  2864. (make-directory-internal DIRECTORY)Fdelete-directory
  2865. Delete the directory named DIRECTORY.
  2866.  
  2867. (delete-directory DIRECTORY)Fdelete-file
  2868. Delete file named FILENAME.
  2869. If file has multiple names, it continues to exist with the other names.
  2870.  
  2871. (delete-file FILENAME)Frename-file
  2872. Rename FILE as NEWNAME.  Both args strings.
  2873. If file has names other than FILE, it continues to have those names.
  2874. Signals a `file-already-exists' error if a file NEWNAME already exists
  2875. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2876. A number as third arg means request confirmation if NEWNAME already exists.
  2877. This is what happens in interactive use with M-x.
  2878.  
  2879. (rename-file FILE NEWNAME &optional OK-IF-ALREADY-EXISTS)Fadd-name-to-file
  2880. Give FILE additional name NEWNAME.  Both args strings.
  2881. Signals a `file-already-exists' error if a file NEWNAME already exists
  2882. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2883. A number as third arg means request confirmation if NEWNAME already exists.
  2884. This is what happens in interactive use with M-x.
  2885.  
  2886. (add-name-to-file FILE NEWNAME &optional OK-IF-ALREADY-EXISTS)Fmake-symbolic-link
  2887. Make a symbolic link to FILENAME, named LINKNAME.  Both args strings.
  2888. Signals a `file-already-exists' error if a file LINKNAME already exists
  2889. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2890. A number as third arg means request confirmation if LINKNAME already exists.
  2891. This happens for interactive use with M-x.
  2892.  
  2893. (make-symbolic-link FILENAME LINKNAME &optional OK-IF-ALREADY-EXISTS)Fdefine-logical-name
  2894. Define the job-wide logical name NAME to have the value STRING.
  2895. If STRING is nil or a null string, the logical name NAME is deleted.
  2896.  
  2897. (define-logical-name NAME STRING)Fsysnetunam
  2898. Open a network connection to PATH using LOGIN as the login string.
  2899.  
  2900. (sysnetunam PATH LOGIN)Ffile-name-absolute-p
  2901. Return t if file FILENAME specifies an absolute file name.
  2902. On Unix, this is a name starting with a `/' or a `~'.
  2903.  
  2904. (file-name-absolute-p FILENAME)Ffile-exists-p
  2905. Return t if file FILENAME exists.  (This does not mean you can read it.)
  2906. See also `file-readable-p' and `file-attributes'.
  2907.  
  2908. (file-exists-p FILENAME)Ffile-executable-p
  2909. Return t if FILENAME can be executed by you.
  2910. For a directory, this means you can access files in that directory.
  2911.  
  2912. (file-executable-p FILENAME)Ffile-readable-p
  2913. Return t if file FILENAME exists and you can read it.
  2914. See also `file-exists-p' and `file-attributes'.
  2915.  
  2916. (file-readable-p FILENAME)Ffile-writable-p
  2917. Return t if file FILENAME can be written or created by you.
  2918.  
  2919. (file-writable-p FILENAME)Ffile-symlink-p
  2920. Return non-nil if file FILENAME is the name of a symbolic link.
  2921. The value is the name of the file to which it is linked.
  2922. Otherwise returns nil.
  2923.  
  2924. (file-symlink-p FILENAME)Ffile-directory-p
  2925. Return t if file FILENAME is the name of a directory as a file.
  2926. A directory name spec may be given instead; then the value is t
  2927. if the directory so specified exists and really is a directory.
  2928.  
  2929. (file-directory-p FILENAME)Ffile-accessible-directory-p
  2930. Return t if file FILENAME is the name of a directory as a file,
  2931. and files in that directory can be opened by you.  In order to use a
  2932. directory as a buffer's current directory, this predicate must return true.
  2933. A directory name spec may be given instead; then the value is t
  2934. if the directory so specified exists and really is a readable and
  2935. searchable directory.
  2936.  
  2937. (file-accessible-directory-p FILENAME)Ffile-regular-p
  2938. Return t if file FILENAME is the name of a regular file.
  2939. This is the sort of file that holds an ordinary stream of data bytes.
  2940.  
  2941. (file-regular-p FILENAME)Ffile-modes
  2942. Return mode bits of file named FILENAME, as an integer.
  2943.  
  2944. (file-modes FILENAME)Fset-file-modes
  2945. Set mode bits of file named FILENAME to MODE (an integer).
  2946. Only the 12 low bits of MODE are used.
  2947.  
  2948. (set-file-modes FILENAME MODE)Fset-default-file-modes
  2949. Set the file permission bits for newly created files.
  2950. The argument MODE should be an integer; only the low 9 bits are used.
  2951. This setting is inherited by subprocesses.
  2952.  
  2953. (set-default-file-modes MODE)Fdefault-file-modes
  2954. Return the default file protection for created files.
  2955. The value is an integer.
  2956.  
  2957. (default-file-modes)Funix-sync
  2958. Tell Unix to finish all pending disk updates.
  2959.  
  2960. (unix-sync)Ffile-newer-than-file-p
  2961. Return t if file FILE1 is newer than file FILE2.
  2962. If FILE1 does not exist, the answer is nil;
  2963. otherwise, if FILE2 does not exist, the answer is t.
  2964.  
  2965. (file-newer-than-file-p FILE1 FILE2)Finsert-file-contents
  2966. Insert contents of file FILENAME after point.
  2967. Returns list of absolute file name and length of data inserted.
  2968. If second argument VISIT is non-nil, the buffer's visited filename
  2969. and last save file modtime are set, and it is marked unmodified.
  2970. If visiting and the file does not exist, visiting is completed
  2971. before the error is signaled.
  2972.  
  2973. The optional third and fourth arguments BEG and END
  2974. specify what portion of the file to insert.
  2975. If VISIT is non-nil, BEG and END must be nil.
  2976. If optional fifth argument REPLACE is non-nil,
  2977. it means replace the current buffer contents (in the accessible portion)
  2978. with the file contents.  This is better than simply deleting and inserting
  2979. the whole thing because (1) it preserves some marker positions
  2980. and (2) it puts less data in the undo list.
  2981.  
  2982. (insert-file-contents FILENAME &optional VISIT BEG END REPLACE)Fwrite-region
  2983. Write current region into specified file.
  2984. When called from a program, takes three arguments:
  2985. START, END and FILENAME.  START and END are buffer positions.
  2986. Optional fourth argument APPEND if non-nil means
  2987.   append to existing file contents (if any).
  2988. Optional fifth argument VISIT if t means
  2989.   set the last-save-file-modtime of buffer to this file's modtime
  2990.   and mark buffer not modified.
  2991. If VISIT is a string, it is a second file name;
  2992.   the output goes to FILENAME, but the buffer is marked as visiting VISIT.
  2993.   VISIT is also the file name to lock and unlock for clash detection.
  2994. If VISIT is neither t nor nil nor a string,
  2995.   that means do not print the "Wrote file" message.
  2996. The optional sixth arg LOCKNAME, if non-nil, specifies the name to
  2997.   use for locking and unlocking, overriding FILENAME and VISIT.
  2998. Kludgy feature: if START is a string, then that string is written
  2999. to the file, instead of any buffer contents, and END is ignored.
  3000.  
  3001. (write-region START END FILENAME &optional APPEND VISIT LOCKNAME)Fcar-less-than-car
  3002. Return t if (car A) is numerically less than (car B).
  3003.  
  3004. (car-less-than-car A B)Fverify-visited-file-modtime
  3005. Return t if last mod time of BUF's visited file matches what BUF records.
  3006. This means that the file has not been changed since it was visited or saved.
  3007.  
  3008. (verify-visited-file-modtime BUF)Fclear-visited-file-modtime
  3009. Clear out records of last mod time of visited file.
  3010. Next attempt to save will certainly not complain of a discrepancy.
  3011.  
  3012. (clear-visited-file-modtime)Fvisited-file-modtime
  3013. Return the current buffer's recorded visited file modification time.
  3014. The value is a list of the form (HIGH . LOW), like the time values
  3015. that `file-attributes' returns.
  3016.  
  3017. (visited-file-modtime)Fset-visited-file-modtime
  3018. Update buffer's recorded modification time from the visited file's time.
  3019. Useful if the buffer was not read from the file normally
  3020. or if the file itself has been changed for some known benign reason.
  3021. An argument specifies the modification time value to use
  3022. (instead of that of the visited file), in the form of a list
  3023. (HIGH . LOW) or (HIGH LOW).
  3024.  
  3025. (set-visited-file-modtime &optional TIME-LIST)Fdo-auto-save
  3026. Auto-save all buffers that need it.
  3027. This is all buffers that have auto-saving enabled
  3028. and are changed since last auto-saved.
  3029. Auto-saving writes the buffer into a file
  3030. so that your editing is not lost if the system crashes.
  3031. This file is not the file you visited; that changes only when you save.
  3032. Normally we run the normal hook `auto-save-hook' before saving.
  3033.  
  3034. A non-nil NO-MESSAGE argument means do not print any message if successful.
  3035. A non-nil CURRENT-ONLY argument means save only current buffer.
  3036.  
  3037. (do-auto-save &optional NO-MESSAGE CURRENT-ONLY)Fset-buffer-auto-saved
  3038. Mark current buffer as auto-saved with its current text.
  3039. No auto-save file will be written until the buffer changes again.
  3040.  
  3041. (set-buffer-auto-saved)Fclear-buffer-auto-save-failure
  3042. Clear any record of a recent auto-save failure in the current buffer.
  3043.  
  3044. (clear-buffer-auto-save-failure)Frecent-auto-save-p
  3045. Return t if buffer has been auto-saved since last read in or saved.
  3046.  
  3047. (recent-auto-save-p)Fread-file-name-internal
  3048. Internal subroutine for read-file-name.  Do not call this.
  3049.  
  3050. (read-file-name-internal STRING DIR ACTION)Fread-file-name
  3051. Read file name, prompting with PROMPT and completing in directory DIR.
  3052. Value is not expanded---you must call `expand-file-name' yourself.
  3053. Default name to DEFAULT-FILENAME if user enters a null string.
  3054.  (If DEFAULT-FILENAME is omitted, the visited file name is used,
  3055.   except that if INITIAL is specified, that combined with DIR is used.)
  3056. Fourth arg MUSTMATCH non-nil means require existing file's name.
  3057.  Non-nil and non-t means also require confirmation after completion.
  3058. Fifth arg INITIAL specifies text to start with.
  3059. DIR defaults to current buffer's directory default.
  3060.  
  3061. (read-file-name PROMPT &optional DIR DEFAULT-FILENAME MUSTMATCH INITIAL)Vauto-save-file-format
  3062. *Format in which to write auto-save files.
  3063. Should be a list of symbols naming formats that are defined in `format-alist'.
  3064. If it is t, which is the default, auto-save files are written in the
  3065. same format as a regular save would use.Vinsert-default-directory
  3066. *Non-nil means when reading a filename start with default dir in minibuffer.Vvms-stmlf-recfm
  3067. *Non-nil means write new files with record format `stmlf'.
  3068. nil means use format `var'.  This variable is meaningful only on VMS.Vdirectory-sep-char
  3069. Directory separator character for built-in functions that return file names.
  3070. The value should be either ?/ or ?\ (any other value is treated as ?\).
  3071. This variable affects the built-in functions only on Windows,
  3072. on other platforms, it is initialized so that Lisp code can find out
  3073. what the normal separator is.Vfile-name-handler-alist
  3074. *Alist of elements (REGEXP . HANDLER) for file names handled specially.
  3075. If a file name matches REGEXP, then all I/O on that file is done by calling
  3076. HANDLER.
  3077.  
  3078. The first argument given to HANDLER is the name of the I/O primitive
  3079. to be handled; the remaining arguments are the arguments that were
  3080. passed to that primitive.  For example, if you do
  3081.     (file-exists-p FILENAME)
  3082. and FILENAME is handled by HANDLER, then HANDLER is called like this:
  3083.     (funcall HANDLER 'file-exists-p FILENAME)
  3084. The function `find-file-name-handler' checks this list for a handler
  3085. for its argument.Vafter-insert-file-functions
  3086. A list of functions to be called at the end of `insert-file-contents'.
  3087. Each is passed one argument, the number of bytes inserted.  It should return
  3088. the new byte count, and leave point the same.  If `insert-file-contents' is
  3089. intercepted by a handler from `file-name-handler-alist', that handler is
  3090. responsible for calling the after-insert-file-functions if appropriate.Vwrite-region-annotate-functions
  3091. A list of functions to be called at the start of `write-region'.
  3092. Each is passed two arguments, START and END as for `write-region'.
  3093. These are usually two numbers but not always; see the documentation
  3094. for `write-region'.  The function should return a list of pairs
  3095. of the form (POSITION . STRING), consisting of strings to be effectively
  3096. inserted at the specified positions of the file being written (1 means to
  3097. insert before the first byte written).  The POSITIONs must be sorted into
  3098. increasing order.  If there are several functions in the list, the several
  3099. lists are merged destructively.Vwrite-region-annotations-so-far
  3100. When an annotation function is called, this holds the previous annotations.
  3101. These are the annotations made by other annotation functions
  3102. that were already called.  See also `write-region-annotate-functions'.Vinhibit-file-name-handlers
  3103. A list of file name handlers that temporarily should not be used.
  3104. This applies only to the operation `inhibit-file-name-operation'.Vinhibit-file-name-operation
  3105. The operation for which `inhibit-file-name-handlers' is applicable.Vauto-save-list-file-name
  3106. File name in which we write a list of all auto save file names.
  3107. This variable is initialized automatically from `auto-save-list-file-prefix'
  3108. shortly after Emacs reads your `.emacs' file, if you have not yet given it
  3109. a non-nil value.Fdirectory-files
  3110. Return a list of names of files in DIRECTORY.
  3111. There are three optional arguments:
  3112. If FULL is non-nil, return absolute file names.  Otherwise return names
  3113.  that are relative to the specified directory.
  3114. If MATCH is non-nil, mention only file names that match the regexp MATCH.
  3115. If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
  3116.  NOSORT is useful if you plan to sort the result yourself.
  3117.  
  3118. (directory-files DIRECTORY &optional FULL MATCH NOSORT)Ffile-name-completion
  3119. Complete file name FILE in directory DIRECTORY.
  3120. Returns the longest string
  3121. common to all file names in DIRECTORY that start with FILE.
  3122. If there is only one and FILE matches it exactly, returns t.
  3123. Returns nil if DIR contains no name starting with FILE.
  3124.  
  3125. (file-name-completion FILE DIRECTORY)Ffile-name-all-completions
  3126. Return a list of all completions of file name FILE in directory DIRECTORY.
  3127. These are all file names in directory DIRECTORY which begin with FILE.
  3128.  
  3129. (file-name-all-completions FILE DIRECTORY)Ffile-name-all-versions
  3130. Return a list of all versions of file name FILE in directory DIRECTORY.
  3131.  
  3132. (file-name-all-versions FILE DIRECTORY)Ffile-version-limit
  3133. Return the maximum number of versions allowed for FILE.
  3134. Returns nil if the file cannot be opened or if there is no version limit.
  3135.  
  3136. (file-version-limit FILENAME)Ffile-attributes
  3137. Return a list of attributes of file FILENAME.
  3138. Value is nil if specified file cannot be opened.
  3139. Otherwise, list elements are:
  3140.  0. t for directory, string (name linked to) for symbolic link, or nil.
  3141.  1. Number of links to file.
  3142.  2. File uid.
  3143.  3. File gid.
  3144.  4. Last access time, as a list of two integers.
  3145.   First integer has high-order 16 bits of time, second has low 16 bits.
  3146.  5. Last modification time, likewise.
  3147.  6. Last status change time, likewise.
  3148.  7. Size in bytes (-1, if number is out of range).
  3149.  8. File modes, as a string of ten letters or dashes as in ls -l.
  3150.  9. t iff file's gid would change if file were deleted and recreated.
  3151. 10. inode number.
  3152. 11. Device number.
  3153.  
  3154. If file does not exist, returns nil.
  3155.  
  3156. (file-attributes FILENAME)Vcompletion-ignored-extensions
  3157. *Completion ignores filenames ending in any string in this list.
  3158. This variable does not affect lists of possible completions,
  3159. but does affect the commands that actually do completions.Fforward-char
  3160. Move point right N characters (left if N is negative).
  3161. On reaching end of buffer, stop and signal error.
  3162.  
  3163. (forward-char &optional N)Fbackward-char
  3164. Move point left N characters (right if N is negative).
  3165. On attempt to pass beginning or end of buffer, stop and signal error.
  3166.  
  3167. (backward-char &optional N)Fforward-line
  3168. Move N lines forward (backward if N is negative).
  3169. Precisely, if point is on line I, move to the start of line I + N.
  3170. If there isn't room, go as far as possible (no error).
  3171. Returns the count of lines left to move.  If moving forward,
  3172. that is N - number of lines moved; if backward, N + number moved.
  3173. With positive N, a non-empty line at the end counts as one line
  3174.   successfully moved (for the return value).
  3175.  
  3176. (forward-line &optional N)Fbeginning-of-line
  3177. Move point to beginning of current line.
  3178. With argument N not nil or 1, move forward N - 1 lines first.
  3179. If scan reaches end of buffer, stop there without error.
  3180.  
  3181. (beginning-of-line &optional N)Fend-of-line
  3182. Move point to end of current line.
  3183. With argument N not nil or 1, move forward N - 1 lines first.
  3184. If scan reaches end of buffer, stop there without error.
  3185.  
  3186. (end-of-line &optional N)Fdelete-char
  3187. Delete the following N characters (previous if N is negative).
  3188. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  3189. Interactively, N is the prefix arg, and KILLFLAG is set if
  3190. N was explicitly specified.
  3191.  
  3192. (delete-char N &optional KILLFLAG)Fdelete-backward-char
  3193. Delete the previous N characters (following if N is negative).
  3194. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  3195. Interactively, N is the prefix arg, and KILLFLAG is set if
  3196. N was explicitly specified.
  3197.  
  3198. (delete-backward-char N &optional KILLFLAG)Fself-insert-command
  3199. Insert the character you type.
  3200. Whichever character you type to run this command is inserted.
  3201.  
  3202. (self-insert-command N)Vself-insert-face
  3203. If non-nil, set the face of the next self-inserting character to this.
  3204. See also `self-insert-face-command'.Vself-insert-face-command
  3205. This is the command that set up `self-insert-face'.
  3206. If `last-command' does not equal this value, we ignore `self-insert-face'.Vblink-paren-function
  3207. Function called, if non-nil, whenever a close parenthesis is inserted.
  3208. More precisely, a char with closeparen syntax is self-inserted.Fcase-table-p
  3209. Return t iff OBJECT is a case table.
  3210. See `set-case-table' for more information on these data structures.
  3211.  
  3212. (case-table-p OBJECT)Fcurrent-case-table
  3213. Return the case table of the current buffer.
  3214.  
  3215. (current-case-table)Fstandard-case-table
  3216. Return the standard case table.
  3217. This is the one used for new buffers.
  3218.  
  3219. (standard-case-table)Fset-case-table
  3220. Select a new case table for the current buffer.
  3221. A case table is a char-table which maps characters
  3222. to their lower-case equivalents.  It also has three "extra" slots
  3223. which may be additional char-tables or nil.
  3224. These slots are called UPCASE, CANONICALIZE and EQUIVALENCES.
  3225. UPCASE maps each character to its upper-case equivalent;
  3226.  if lower and upper case characters are in 1-1 correspondence,
  3227.  you may use nil and the upcase table will be deduced from DOWNCASE.
  3228. CANONICALIZE maps each character to a canonical equivalent;
  3229.  any two characters that are related by case-conversion have the same
  3230.  canonical equivalent character; it may be nil, in which case it is
  3231.  deduced from DOWNCASE and UPCASE.
  3232. EQUIVALENCES is a map that cyclicly permutes each equivalence class
  3233.  (of characters with the same canonical equivalent); it may be nil,
  3234.  in which case it is deduced from CANONICALIZE.
  3235.  
  3236. (set-case-table TABLE)Fset-standard-case-table
  3237. Select a new standard case table for new buffers.
  3238. See `set-case-table' for more info on case tables.
  3239.  
  3240. (set-standard-case-table TABLE)Fupcase
  3241. Convert argument to upper case and return that.
  3242. The argument may be a character or string.  The result has the same type.
  3243. The argument object is not altered--the value is a copy.
  3244. See also `capitalize', `downcase' and `upcase-initials'.
  3245.  
  3246. (upcase OBJ)Fdowncase
  3247. Convert argument to lower case and return that.
  3248. The argument may be a character or string.  The result has the same type.
  3249. The argument object is not altered--the value is a copy.
  3250.  
  3251. (downcase OBJ)Fcapitalize
  3252. Convert argument to capitalized form and return that.
  3253. This means that each word's first character is upper case
  3254. and the rest is lower case.
  3255. The argument may be a character or string.  The result has the same type.
  3256. The argument object is not altered--the value is a copy.
  3257.  
  3258. (capitalize OBJ)Fupcase-initials
  3259. Convert the initial of each word in the argument to upper case.
  3260. Do not change the other letters of each word.
  3261. The argument may be a character or string.  The result has the same type.
  3262. The argument object is not altered--the value is a copy.
  3263.  
  3264. (upcase-initials OBJ)Fupcase-region
  3265. Convert the region to upper case.  In programs, wants two arguments.
  3266. These arguments specify the starting and ending character numbers of
  3267. the region to operate on.  When used as a command, the text between
  3268. point and the mark is operated on.
  3269. See also `capitalize-region'.
  3270.  
  3271. (upcase-region BEG END)Fdowncase-region
  3272. Convert the region to lower case.  In programs, wants two arguments.
  3273. These arguments specify the starting and ending character numbers of
  3274. the region to operate on.  When used as a command, the text between
  3275. point and the mark is operated on.
  3276.  
  3277. (downcase-region BEG END)Fcapitalize-region
  3278. Convert the region to capitalized form.
  3279. Capitalized form means each word's first character is upper case
  3280. and the rest of it is lower case.
  3281. In programs, give two arguments, the starting and ending
  3282. character positions to operate on.
  3283.  
  3284. (capitalize-region BEG END)Fupcase-initials-region
  3285. Upcase the initial of each word in the region.
  3286. Subsequent letters of each word are not changed.
  3287. In programs, give two arguments, the starting and ending
  3288. character positions to operate on.
  3289.  
  3290. (upcase-initials-region BEG END)Fupcase-word
  3291. Convert following word (or ARG words) to upper case, moving over.
  3292. With negative argument, convert previous words but do not move.
  3293. See also `capitalize-word'.
  3294.  
  3295. (upcase-word ARG)Fdowncase-word
  3296. Convert following word (or ARG words) to lower case, moving over.
  3297. With negative argument, convert previous words but do not move.
  3298.  
  3299. (downcase-word ARG)Fcapitalize-word
  3300. Capitalize the following word (or ARG words), moving over.
  3301. This gives the word(s) a first character in upper case
  3302. and the rest lower case.
  3303. With negative argument, capitalize previous words but do not move.
  3304.  
  3305. (capitalize-word ARG)Fcurrent-column
  3306. Return the horizontal position of point.  Beginning of line is column 0.
  3307. This is calculated by adding together the widths of all the displayed
  3308. representations of the character between the start of the previous line
  3309. and point.  (eg control characters will have a width of 2 or 4, tabs
  3310. will have a variable width)
  3311. Ignores finite width of frame, which means that this function may return
  3312. values greater than (frame-width).
  3313. Whether the line is visible (if `selective-display' is t) has no effect;
  3314. however, ^M is treated as end of line when `selective-display' is t.
  3315.  
  3316. (current-column)Findent-to
  3317. Indent from point with tabs and spaces until COLUMN is reached.
  3318. Optional second argument MININUM says always do at least MININUM spaces
  3319. even if that goes past COLUMN; by default, MININUM is zero.
  3320.  
  3321. (indent-to COLUMN &optional MINIMUM)Fcurrent-indentation
  3322. Return the indentation of the current line.
  3323. This is the horizontal position of the character
  3324. following any initial whitespace.
  3325.  
  3326. (current-indentation)Fmove-to-column
  3327. Move point to column COLUMN in the current line.
  3328. The column of a character is calculated by adding together the widths
  3329. as displayed of the previous characters in the line.
  3330. This function ignores line-continuation;
  3331. there is no upper limit on the column number a character can have
  3332. and horizontal scrolling has no effect.
  3333.  
  3334. If specified column is within a character, point goes after that character.
  3335. If it's past end of line, point goes to end of line.
  3336.  
  3337. A non-nil second (optional) argument FORCE means, if the line
  3338. is too short to reach column COLUMN then add spaces/tabs to get there,
  3339. and if COLUMN is in the middle of a tab character, change it to spaces.
  3340.  
  3341. The return value is the current column.
  3342.  
  3343. (move-to-column COLUMN &optional FORCE)Fcompute-motion
  3344. Scan through the current buffer, calculating screen position.
  3345. Scan the current buffer forward from offset FROM,
  3346. assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
  3347. to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
  3348. and return the ending buffer position and screen location.
  3349.  
  3350. There are three additional arguments:
  3351.  
  3352. WIDTH is the number of columns available to display text;
  3353. this affects handling of continuation lines.
  3354. This is usually the value returned by `window-width', less one (to allow
  3355. for the continuation glyph).
  3356.  
  3357. OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
  3358. HSCROLL is the number of columns not being displayed at the left
  3359. margin; this is usually taken from a window's hscroll member.
  3360. TAB-OFFSET is the number of columns of the first tab that aren't
  3361. being displayed, perhaps because the line was continued within it.
  3362. If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
  3363.  
  3364. WINDOW is the window to operate on.  It is used to choose the display table;
  3365. if it is showing the current buffer, it is used also for
  3366. deciding which overlay properties apply.
  3367. Note that `compute-motion' always operates on the current buffer.
  3368.  
  3369. The value is a list of five elements:
  3370.   (POS HPOS VPOS PREVHPOS CONTIN)
  3371. POS is the buffer position where the scan stopped.
  3372. VPOS is the vertical position where the scan stopped.
  3373. HPOS is the horizontal position where the scan stopped.
  3374.  
  3375. PREVHPOS is the horizontal position one character back from POS.
  3376. CONTIN is t if a line was continued after (or within) the previous character.
  3377.  
  3378. For example, to find the buffer position of column COL of line LINE
  3379. of a certain window, pass the window's starting location as FROM
  3380. and the window's upper-left coordinates as FROMPOS.
  3381. Pass the buffer's (point-max) as TO, to limit the scan to the end of the
  3382. visible section of the buffer, and pass LINE and COL as TOPOS.
  3383.  
  3384. (compute-motion FROM FROMPOS TO TOPOS WIDTH OFFSETS WINDOW)Fvertical-motion
  3385. Move point to start of the screen line LINES lines down.
  3386. If LINES is negative, this means moving up.
  3387.  
  3388. This function is an ordinary cursor motion function
  3389. which calculates the new position based on how text would be displayed.
  3390. The new position may be the start of a line,
  3391. or just the start of a continuation line.
  3392. The function returns number of screen lines moved over;
  3393. that usually equals LINES, but may be closer to zero
  3394. if beginning or end of buffer was reached.
  3395.  
  3396. The optional second argument WINDOW specifies the window to use for
  3397. parameters such as width, horizontal scrolling, and so on.
  3398. The default is to use the selected window's parameters.
  3399.  
  3400. `vertical-motion' always uses the current buffer,
  3401. regardless of which buffer is displayed in WINDOW.
  3402. This is consistent with other cursor motion functions
  3403. and makes it possible to use `vertical-motion' in any buffer,
  3404. whether or not it is currently displayed in some window.
  3405.  
  3406. (vertical-motion LINES &optional WINDOW)Vindent-tabs-mode
  3407. *Indentation can insert tabs if this is non-nil.
  3408. Setting this variable automatically makes it local to the current buffer.Flooking-at
  3409. Return t if text after point matches regular expression REGEXP.
  3410. This function modifies the match data that `match-beginning',
  3411. `match-end' and `match-data' access; save and restore the match
  3412. data if you want to preserve them.
  3413.  
  3414. (looking-at REGEXP)Fposix-looking-at
  3415. Return t if text after point matches regular expression REGEXP.
  3416. Find the longest match, in accord with Posix regular expression rules.
  3417. This function modifies the match data that `match-beginning',
  3418. `match-end' and `match-data' access; save and restore the match
  3419. data if you want to preserve them.
  3420.  
  3421. (posix-looking-at REGEXP)Fstring-match
  3422. Return index of start of first match for REGEXP in STRING, or nil.
  3423. If third arg START is non-nil, start search at that index in STRING.
  3424. For index of first char beyond the match, do (match-end 0).
  3425. `match-end' and `match-beginning' also give indices of substrings
  3426. matched by parenthesis constructs in the pattern.
  3427.  
  3428. (string-match REGEXP STRING &optional START)Fposix-string-match
  3429. Return index of start of first match for REGEXP in STRING, or nil.
  3430. Find the longest match, in accord with Posix regular expression rules.
  3431. If third arg START is non-nil, start search at that index in STRING.
  3432. For index of first char beyond the match, do (match-end 0).
  3433. `match-end' and `match-beginning' also give indices of substrings
  3434. matched by parenthesis constructs in the pattern.
  3435.  
  3436. (posix-string-match REGEXP STRING &optional START)Fskip-chars-forward
  3437. Move point forward, stopping before a char not in STRING, or at pos LIM.
  3438. STRING is like the inside of a `[...]' in a regular expression
  3439. except that `]' is never special and `\' quotes `^', `-' or `\'.
  3440. Thus, with arg "a-zA-Z", this skips letters stopping before first nonletter.
  3441. With arg "^a-zA-Z", skips nonletters stopping before first letter.
  3442. Returns the distance traveled, either zero or positive.
  3443.  
  3444. (skip-chars-forward STRING &optional LIM)Fskip-chars-backward
  3445. Move point backward, stopping after a char not in STRING, or at pos LIM.
  3446. See `skip-chars-forward' for details.
  3447. Returns the distance traveled, either zero or negative.
  3448.  
  3449. (skip-chars-backward STRING &optional LIM)Fskip-syntax-forward
  3450. Move point forward across chars in specified syntax classes.
  3451. SYNTAX is a string of syntax code characters.
  3452. Stop before a char whose syntax is not in SYNTAX, or at position LIM.
  3453. If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
  3454. This function returns the distance traveled, either zero or positive.
  3455.  
  3456. (skip-syntax-forward SYNTAX &optional LIM)Fskip-syntax-backward
  3457. Move point backward across chars in specified syntax classes.
  3458. SYNTAX is a string of syntax code characters.
  3459. Stop on reaching a char whose syntax is not in SYNTAX, or at position LIM.
  3460. If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
  3461. This function returns the distance traveled, either zero or negative.
  3462.  
  3463. (skip-syntax-backward SYNTAX &optional LIM)Fsearch-backward
  3464. Search backward from point for STRING.
  3465. Set point to the beginning of the occurrence found, and return point.
  3466. An optional second argument bounds the search; it is a buffer position.
  3467. The match found must not extend before that position.
  3468. Optional third argument, if t, means if fail just return nil (no error).
  3469.  If not nil and not t, position at limit of search and return nil.
  3470. Optional fourth argument is repeat count--search for successive occurrences.
  3471. See also the functions `match-beginning', `match-end' and `replace-match'.
  3472.  
  3473. (search-backward STRING &optional BOUND NOERROR COUNT)Fsearch-forward
  3474. Search forward from point for STRING.
  3475. Set point to the end of the occurrence found, and return point.
  3476. An optional second argument bounds the search; it is a buffer position.
  3477. The match found must not extend after that position.  nil is equivalent
  3478.   to (point-max).
  3479. Optional third argument, if t, means if fail just return nil (no error).
  3480.   If not nil and not t, move to limit of search and return nil.
  3481. Optional fourth argument is repeat count--search for successive occurrences.
  3482. See also the functions `match-beginning', `match-end' and `replace-match'.
  3483.  
  3484. (search-forward STRING &optional BOUND NOERROR COUNT)Fword-search-backward
  3485. Search backward from point for STRING, ignoring differences in punctuation.
  3486. Set point to the beginning of the occurrence found, and return point.
  3487. An optional second argument bounds the search; it is a buffer position.
  3488. The match found must not extend before that position.
  3489. Optional third argument, if t, means if fail just return nil (no error).
  3490.   If not nil and not t, move to limit of search and return nil.
  3491. Optional fourth argument is repeat count--search for successive occurrences.
  3492.  
  3493. (word-search-backward STRING &optional BOUND NOERROR COUNT)Fword-search-forward
  3494. Search forward from point for STRING, ignoring differences in punctuation.
  3495. Set point to the end of the occurrence found, and return point.
  3496. An optional second argument bounds the search; it is a buffer position.
  3497. The match found must not extend after that position.
  3498. Optional third argument, if t, means if fail just return nil (no error).
  3499.   If not nil and not t, move to limit of search and return nil.
  3500. Optional fourth argument is repeat count--search for successive occurrences.
  3501.  
  3502. (word-search-forward STRING &optional BOUND NOERROR COUNT)Fre-search-backward
  3503. Search backward from point for match for regular expression REGEXP.
  3504. Set point to the beginning of the match, and return point.
  3505. The match found is the one starting last in the buffer
  3506. and yet ending before the origin of the search.
  3507. An optional second argument bounds the search; it is a buffer position.
  3508. The match found must start at or after that position.
  3509. Optional third argument, if t, means if fail just return nil (no error).
  3510.   If not nil and not t, move to limit of search and return nil.
  3511. Optional fourth argument is repeat count--search for successive occurrences.
  3512. See also the functions `match-beginning', `match-end' and `replace-match'.
  3513.  
  3514. (re-search-backward REGEXP &optional BOUND NOERROR COUNT)Fre-search-forward
  3515. Search forward from point for regular expression REGEXP.
  3516. Set point to the end of the occurrence found, and return point.
  3517. An optional second argument bounds the search; it is a buffer position.
  3518. The match found must not extend after that position.
  3519. Optional third argument, if t, means if fail just return nil (no error).
  3520.   If not nil and not t, move to limit of search and return nil.
  3521. Optional fourth argument is repeat count--search for successive occurrences.
  3522. See also the functions `match-beginning', `match-end' and `replace-match'.
  3523.  
  3524. (re-search-forward REGEXP &optional BOUND NOERROR COUNT)Fposix-search-backward
  3525. Search backward from point for match for regular expression REGEXP.
  3526. Find the longest match in accord with Posix regular expression rules.
  3527. Set point to the beginning of the match, and return point.
  3528. The match found is the one starting last in the buffer
  3529. and yet ending before the origin of the search.
  3530. An optional second argument bounds the search; it is a buffer position.
  3531. The match found must start at or after that position.
  3532. Optional third argument, if t, means if fail just return nil (no error).
  3533.   If not nil and not t, move to limit of search and return nil.
  3534. Optional fourth argument is repeat count--search for successive occurrences.
  3535. See also the functions `match-beginning', `match-end' and `replace-match'.
  3536.  
  3537. (posix-search-backward REGEXP &optional BOUND NOERROR COUNT)Fposix-search-forward
  3538. Search forward from point for regular expression REGEXP.
  3539. Find the longest match in accord with Posix regular expression rules.
  3540. Set point to the end of the occurrence found, and return point.
  3541. An optional second argument bounds the search; it is a buffer position.
  3542. The match found must not extend after that position.
  3543. Optional third argument, if t, means if fail just return nil (no error).
  3544.   If not nil and not t, move to limit of search and return nil.
  3545. Optional fourth argument is repeat count--search for successive occurrences.
  3546. See also the functions `match-beginning', `match-end' and `replace-match'.
  3547.  
  3548. (posix-search-forward REGEXP &optional BOUND NOERROR COUNT)Freplace-match
  3549. Replace text matched by last search with NEWTEXT.
  3550. If second arg FIXEDCASE is non-nil, do not alter case of replacement text.
  3551. Otherwise maybe capitalize the whole text, or maybe just word initials,
  3552. based on the replaced text.
  3553. If the replaced text has only capital letters
  3554. and has at least one multiletter word, convert NEWTEXT to all caps.
  3555. If the replaced text has at least one word starting with a capital letter,
  3556. then capitalize each word in NEWTEXT.
  3557.  
  3558. If third arg LITERAL is non-nil, insert NEWTEXT literally.
  3559. Otherwise treat `\' as special:
  3560.   `\&' in NEWTEXT means substitute original matched text.
  3561.   `\N' means substitute what matched the Nth `\(...\)'.
  3562.        If Nth parens didn't match, substitute nothing.
  3563.   `\\' means insert one `\'.
  3564. FIXEDCASE and LITERAL are optional arguments.
  3565. Leaves point at end of replacement text.
  3566.  
  3567. The optional fourth argument STRING can be a string to modify.
  3568. In that case, this function creates and returns a new string
  3569. which is made by replacing the part of STRING that was matched.
  3570.  
  3571. The optional fifth argument SUBEXP specifies a subexpression of the match.
  3572. It says to replace just that subexpression instead of the whole match.
  3573. This is useful only after a regular expression search or match
  3574. since only regular expressions have distinguished subexpressions.
  3575.  
  3576. (replace-match NEWTEXT &optional FIXEDCASE LITERAL STRING SUBEXP)Fmatch-beginning
  3577. Return position of start of text matched by last search.
  3578. SUBEXP, a number, specifies which parenthesized expression in the last
  3579.   regexp.
  3580. Value is nil if SUBEXPth pair didn't match, or there were less than
  3581.   SUBEXP pairs.
  3582. Zero means the entire text matched by the whole regexp or whole string.
  3583.  
  3584. (match-beginning SUBEXP)Fmatch-end
  3585. Return position of end of text matched by last search.
  3586. SUBEXP, a number, specifies which parenthesized expression in the last
  3587.   regexp.
  3588. Value is nil if SUBEXPth pair didn't match, or there were less than
  3589.   SUBEXP pairs.
  3590. Zero means the entire text matched by the whole regexp or whole string.
  3591.  
  3592. (match-end SUBEXP)Fmatch-data
  3593. Return a list containing all info on what the last search matched.
  3594. Element 2N is `(match-beginning N)'; element 2N + 1 is `(match-end N)'.
  3595. All the elements are markers or nil (nil if the Nth pair didn't match)
  3596. if the last match was on a buffer; integers or nil if a string was matched.
  3597. Use `store-match-data' to reinstate the data in this list.
  3598.  
  3599. (match-data)Fstore-match-data
  3600. Set internal data on last search match from elements of LIST.
  3601. LIST should have been created by calling `match-data' previously.
  3602.  
  3603. (store-match-data LIST)Fregexp-quote
  3604. Return a regexp string which matches exactly STRING and nothing else.
  3605.  
  3606. (regexp-quote STRING)Fundo-boundary
  3607. Mark a boundary between units of undo.
  3608. An undo command will stop at this point,
  3609. but another undo command will undo to the previous boundary.
  3610.  
  3611. (undo-boundary)Fprimitive-undo
  3612. Undo N records from the front of the list LIST.
  3613. Return what remains of the list.
  3614.  
  3615. (primitive-undo N LIST)Fcons
  3616. Create a new cons, give it CAR and CDR as components, and return it.
  3617.  
  3618. (cons CAR CDR)Flist
  3619. Return a newly created list with specified arguments as elements.
  3620. Any number of arguments, even zero arguments, are allowed.Fmake-list
  3621. Return a newly created list of length LENGTH, with each element being INIT.
  3622.  
  3623. (make-list LENGTH INIT)Fmake-vector
  3624. Return a newly created vector of length LENGTH, with each element being INIT.
  3625. See also the function `vector'.
  3626.  
  3627. (make-vector LENGTH INIT)Fmake-char-table
  3628. Return a newly created char-table, with purpose PURPOSE.
  3629. Each element is initialized to INIT, which defaults to nil.
  3630. PURPOSE should be a symbol which has a `char-table-extra-slot' property.
  3631. The property's value should be an integer between 0 and 10.
  3632.  
  3633. (make-char-table PURPOSE &optional INIT)Fvector
  3634. Return a newly created vector with specified arguments as elements.
  3635. Any number of arguments, even zero arguments, are allowed.Fmake-byte-code
  3636. Create a byte-code object with specified arguments as elements.
  3637. The arguments should be the arglist, bytecode-string, constant vector,
  3638. stack size, (optional) doc string, and (optional) interactive spec.
  3639. The first four arguments are required; at most six have any
  3640. significance.Fmake-symbol
  3641. Return a newly allocated uninterned symbol whose name is NAME.
  3642. Its value and function definition are void, and its property list is nil.
  3643.  
  3644. (make-symbol NAME)Fmake-marker
  3645. Return a newly allocated marker which does not point at any place.
  3646.  
  3647. (make-marker)Fmake-string
  3648. Return a newly created string of length LENGTH, with each element being INIT.
  3649. Both LENGTH and INIT must be numbers.
  3650.  
  3651. (make-string LENGTH INIT)Fmake-bool-vector
  3652. Return a newly created bitstring of length LENGTH, with INIT as each element.
  3653. Both LENGTH and INIT must be numbers.  INIT matters only in whether it is t or nil.
  3654.  
  3655. (make-bool-vector LENGTH INIT)Fpurecopy
  3656. Make a copy of OBJECT in pure storage.
  3657. Recursively copies contents of vectors and cons cells.
  3658. Does not copy symbols.
  3659.  
  3660. (purecopy OBJ)Fgarbage-collect
  3661. Reclaim storage for Lisp objects no longer needed.
  3662. Returns info on amount of space in use:
  3663.  ((USED-CONSES . FREE-CONSES) (USED-SYMS . FREE-SYMS)
  3664.   (USED-MARKERS . FREE-MARKERS) USED-STRING-CHARS USED-VECTOR-SLOTS
  3665.   (USED-FLOATS . FREE-FLOATS))
  3666. Garbage collection happens automatically if you cons more than
  3667. `gc-cons-threshold' bytes of Lisp data since previous garbage collection.
  3668.  
  3669. (garbage-collect)Fmemory-limit
  3670. Return the address of the last byte Emacs has allocated, divided by 1024.
  3671. This may be helpful in debugging Emacs's memory usage.
  3672. We divide the value by 1024 to make sure it fits in a Lisp integer.
  3673.  
  3674. (memory-limit)Fmemory-use-counts
  3675. Return a list of counters that measure how much consing there has been.
  3676. Each of these counters increments for a certain kind of object.
  3677. The counters wrap around from the largest positive integer to zero.
  3678. Garbage collection does not decrease them.
  3679. The elements of the value are as follows:
  3680.   (CONSES FLOATS VECTOR-CELLS SYMBOLS STRING-CHARS MISCS INTERVALS)
  3681. All are in units of 1 = one object consed
  3682. except for VECTOR-CELLS and STRING-CHARS, which count the total length of
  3683. objects consed.
  3684. MISCS include overlays, markers, and some internal types.
  3685. Frames, windows, buffers, and subprocesses count as vectors
  3686.   (but the contents of a buffer's text do not count here).
  3687.  
  3688. (memory-use-counts)Vgc-cons-threshold
  3689. *Number of bytes of consing between garbage collections.
  3690. Garbage collection can happen automatically once this many bytes have been
  3691. allocated since the last garbage collection.  All data types count.
  3692.  
  3693. Garbage collection happens automatically only when `eval' is called.
  3694.  
  3695. By binding this temporarily to a large number, you can effectively
  3696. prevent garbage collection during a part of the program.Vpure-bytes-used
  3697. Number of bytes of sharable Lisp data allocated so far.Vdata-bytes-used
  3698. Number of bytes of unshared memory allocated in this session.Vdata-bytes-free
  3699. Number of bytes of unshared memory remaining available in this session.Vpurify-flag
  3700. Non-nil means loading Lisp code in order to dump an executable.
  3701. This means that certain objects should be allocated in shared (pure) space.Vundo-limit
  3702. Keep no more undo information once it exceeds this size.
  3703. This limit is applied when garbage collection happens.
  3704. The size is counted as the number of bytes occupied,
  3705. which includes both saved text and other data.Vundo-strong-limit
  3706. Don't keep more than this much size of undo information.
  3707. A command which pushes past this size is itself forgotten.
  3708. This limit is applied when garbage collection happens.
  3709. The size is counted as the number of bytes occupied,
  3710. which includes both saved text and other data.Vgarbage-collection-messages
  3711. Non-nil means display messages at start and end of garbage collection.Feq
  3712. T if the two args are the same Lisp object.
  3713.  
  3714. (eq OBJ1 OBJ2)Fnull
  3715. T if OBJECT is nil.
  3716.  
  3717. (null OBJECT)Ftype-of
  3718. Return a symbol representing the type of OBJECT.
  3719. The symbol returned names the object's basic type;
  3720. for example, (type-of 1) returns `integer'.
  3721.  
  3722. (type-of OBJECT)Fconsp
  3723. T if OBJECT is a cons cell.
  3724.  
  3725. (consp OBJECT)Fatom
  3726. T if OBJECT is not a cons cell.  This includes nil.
  3727.  
  3728. (atom OBJECT)Flistp
  3729. T if OBJECT is a list.  This includes nil.
  3730.  
  3731. (listp OBJECT)Fnlistp
  3732. T if OBJECT is not a list.  Lists include nil.
  3733.  
  3734. (nlistp OBJECT)Fsymbolp
  3735. T if OBJECT is a symbol.
  3736.  
  3737. (symbolp OBJECT)Fvectorp
  3738. T if OBJECT is a vector.
  3739.  
  3740. (vectorp OBJECT)Fstringp
  3741. T if OBJECT is a string.
  3742.  
  3743. (stringp OBJECT)Fchar-table-p
  3744. T if OBJECT is a char-table.
  3745.  
  3746. (char-table-p OBJECT)Fvector-or-char-table-p
  3747. T if OBJECT is a char-table or vector.
  3748.  
  3749. (vector-or-char-table-p OBJECT)Fbool-vector-p
  3750. T if OBJECT is a bool-vector.
  3751.  
  3752. (bool-vector-p OBJECT)Farrayp
  3753. T if OBJECT is an array (string or vector).
  3754.  
  3755. (arrayp OBJECT)Fsequencep
  3756. T if OBJECT is a sequence (list or array).
  3757.  
  3758. (sequencep OBJECT)Fbufferp
  3759. T if OBJECT is an editor buffer.
  3760.  
  3761. (bufferp OBJECT)Fmarkerp
  3762. T if OBJECT is a marker (editor pointer).
  3763.  
  3764. (markerp OBJECT)Fsubrp
  3765. T if OBJECT is a built-in function.
  3766.  
  3767. (subrp OBJECT)Fbyte-code-function-p
  3768. T if OBJECT is a byte-compiled function object.
  3769.  
  3770. (byte-code-function-p OBJECT)Fchar-or-string-p
  3771. T if OBJECT is a character (an integer) or a string.
  3772.  
  3773. (char-or-string-p OBJECT)Fintegerp
  3774. T if OBJECT is an integer.
  3775.  
  3776. (integerp OBJECT)Finteger-or-marker-p
  3777. T if OBJECT is an integer or a marker (editor pointer).
  3778.  
  3779. (integer-or-marker-p OBJECT)Fnatnump
  3780. T if OBJECT is a nonnegative integer.
  3781.  
  3782. (natnump OBJECT)Fnumberp
  3783. T if OBJECT is a number (floating point or integer).
  3784.  
  3785. (numberp OBJECT)Fnumber-or-marker-p
  3786. T if OBJECT is a number or a marker.
  3787.  
  3788. (number-or-marker-p OBJECT)Ffloatp
  3789. T if OBJECT is a floating point number.
  3790.  
  3791. (floatp OBJECT)Fcar
  3792. Return the car of LIST.  If arg is nil, return nil.
  3793. Error if arg is not nil and not a cons cell.  See also `car-safe'.
  3794.  
  3795. (car LIST)Fcar-safe
  3796. Return the car of OBJECT if it is a cons cell, or else nil.
  3797.  
  3798. (car-safe OBJECT)Fcdr
  3799. Return the cdr of LIST.  If arg is nil, return nil.
  3800. Error if arg is not nil and not a cons cell.  See also `cdr-safe'.
  3801.  
  3802. (cdr LIST)Fcdr-safe
  3803. Return the cdr of OBJECT if it is a cons cell, or else nil.
  3804.  
  3805. (cdr-safe OBJECT)Fsetcar
  3806. Set the car of CELL to be NEWCAR.  Returns NEWCAR.
  3807.  
  3808. (setcar CELL NEWCAR)Fsetcdr
  3809. Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.
  3810.  
  3811. (setcdr CELL NEWCDR)Fboundp
  3812. T if SYMBOL's value is not void.
  3813.  
  3814. (boundp SYMBOL)Ffboundp
  3815. T if SYMBOL's function definition is not void.
  3816.  
  3817. (fboundp SYMBOL)Fmakunbound
  3818. Make SYMBOL's value be void.
  3819.  
  3820. (makunbound SYMBOL)Ffmakunbound
  3821. Make SYMBOL's function definition be void.
  3822.  
  3823. (fmakunbound SYMBOL)Fsymbol-function
  3824. Return SYMBOL's function definition.  Error if that is void.
  3825.  
  3826. (symbol-function SYMBOL)Fsymbol-plist
  3827. Return SYMBOL's property list.
  3828.  
  3829. (symbol-plist SYMBOL)Fsymbol-name
  3830. Return SYMBOL's name, a string.
  3831.  
  3832. (symbol-name SYMBOL)Ffset
  3833. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  3834.  
  3835. (fset SYMBOL NEWDEF)Fdefalias
  3836. Set SYMBOL's function definition to NEWDEF, and return NEWDEF.
  3837. Associates the function with the current load file, if any.
  3838.  
  3839. (defalias SYMBOL NEWDEF)Fdefine-function
  3840. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  3841. Associates the function with the current load file, if any.
  3842.  
  3843. (define-function SYMBOL NEWDEF)Fsetplist
  3844. Set SYMBOL's property list to NEWVAL, and return NEWVAL.
  3845.  
  3846. (setplist SYMBOL NEWPLIST)Fsymbol-value
  3847. Return SYMBOL's value.  Error if that is void.
  3848.  
  3849. (symbol-value SYMBOL)Fset
  3850. Set SYMBOL's value to NEWVAL, and return NEWVAL.
  3851.  
  3852. (set SYMBOL NEWVAL)Fdefault-boundp
  3853. Return T if SYMBOL has a non-void default value.
  3854. This is the value that is seen in buffers that do not have their own values
  3855. for this variable.
  3856.  
  3857. (default-boundp SYMBOL)Fdefault-value
  3858. Return SYMBOL's default value.
  3859. This is the value that is seen in buffers that do not have their own values
  3860. for this variable.  The default value is meaningful for variables with
  3861. local bindings in certain buffers.
  3862.  
  3863. (default-value SYMBOL)Fset-default
  3864. Set SYMBOL's default value to VAL.  SYMBOL and VAL are evaluated.
  3865. The default value is seen in buffers that do not have their own values
  3866. for this variable.
  3867.  
  3868. (set-default SYMBOL VALUE)Fsetq-default
  3869. Set the default value of variable VAR to VALUE.
  3870. VAR, the variable name, is literal (not evaluated);
  3871. VALUE is an expression and it is evaluated.
  3872. The default value of a variable is seen in buffers
  3873. that do not have their own values for the variable.
  3874.  
  3875. More generally, you can use multiple variables and values, as in
  3876.   (setq-default SYMBOL VALUE SYMBOL VALUE...)
  3877. This sets each SYMBOL's default value to the corresponding VALUE.
  3878. The VALUE for the Nth SYMBOL can refer to the new default values
  3879. of previous SYMs.Fmake-variable-buffer-local
  3880. Make VARIABLE have a separate value for each buffer.
  3881. At any time, the value for the current buffer is in effect.
  3882. There is also a default value which is seen in any buffer which has not yet
  3883. set its own value.
  3884. Using `set' or `setq' to set the variable causes it to have a separate value
  3885. for the current buffer if it was previously using the default value.
  3886. The function `default-value' gets the default value and `set-default' sets it.
  3887.  
  3888. (make-variable-buffer-local VARIABLE)Fmake-local-variable
  3889. Make VARIABLE have a separate value in the current buffer.
  3890. Other buffers will continue to share a common default value.
  3891. (The buffer-local value of VARIABLE starts out as the same value
  3892. VARIABLE previously had.  If VARIABLE was void, it remains void.)
  3893. See also `make-variable-buffer-local'.
  3894.  
  3895. If the variable is already arranged to become local when set,
  3896. this function causes a local value to exist for this buffer,
  3897. just as setting the variable would do.
  3898.  
  3899. Do not use `make-local-variable' to make a hook variable buffer-local.
  3900. Use `make-local-hook' instead.
  3901.  
  3902. (make-local-variable VARIABLE)Fkill-local-variable
  3903. Make VARIABLE no longer have a separate value in the current buffer.
  3904. From now on the default value will apply in this buffer.
  3905.  
  3906. (kill-local-variable VARIABLE)Flocal-variable-p
  3907. Non-nil if VARIABLE has a local binding in buffer BUFFER.
  3908. BUFFER defaults to the current buffer.
  3909.  
  3910. (local-variable-p VARIABLE &optional BUFFER)Flocal-variable-if-set-p
  3911. Non-nil if VARIABLE will be local in buffer BUFFER if it is set there.
  3912. BUFFER defaults to the current buffer.
  3913.  
  3914. (local-variable-if-set-p VARIABLE &optional BUFFER)Findirect-function
  3915. Return the function at the end of OBJECT's function chain.
  3916. If OBJECT is a symbol, follow all function indirections and return the final
  3917. function binding.
  3918. If OBJECT is not a symbol, just return it.
  3919. Signal a void-function error if the final symbol is unbound.
  3920. Signal a cyclic-function-indirection error if there is a loop in the
  3921. function chain of symbols.
  3922.  
  3923. (indirect-function OBJECT)Faref
  3924. Return the element of ARRAY at index IDX.
  3925. ARRAY may be a vector, a string, a char-table, a bool-vector,
  3926. or a byte-code object.  IDX starts at 0.
  3927.  
  3928. (aref ARRAY IDX)Faset
  3929. Store into the element of ARRAY at index IDX the value NEWELT.
  3930. ARRAY may be a vector or a string.  IDX starts at 0.
  3931.  
  3932. (aset ARRAY IDX NEWELT)F=
  3933. T if two args, both numbers or markers, are equal.
  3934.  
  3935. (= NUM1 NUM2)F<
  3936. T if first arg is less than second arg.  Both must be numbers or markers.
  3937.  
  3938. (< NUM1 NUM2)F>
  3939. T if first arg is greater than second arg.  Both must be numbers or markers.
  3940.  
  3941. (> NUM1 NUM2)F<=
  3942. T if first arg is less than or equal to second arg.
  3943. Both must be numbers or markers.
  3944.  
  3945. (<= NUM1 NUM2)F>=
  3946. T if first arg is greater than or equal to second arg.
  3947. Both must be numbers or markers.
  3948.  
  3949. (>= NUM1 NUM2)F/=
  3950. T if first arg is not equal to second arg.  Both must be numbers or markers.
  3951.  
  3952. (/= NUM1 NUM2)Fzerop
  3953. T if NUMBER is zero.
  3954.  
  3955. (zerop NUMBER)Fnumber-to-string
  3956. Convert NUMBER to a string by printing it in decimal.
  3957. Uses a minus sign if negative.
  3958. NUMBER may be an integer or a floating point number.
  3959.  
  3960. (number-to-string NUMBER)Fstring-to-number
  3961. Convert STRING to a number by parsing it as a decimal number.
  3962. This parses both integers and floating point numbers.
  3963. It ignores leading spaces and tabs.
  3964.  
  3965. (string-to-number STRING)F+
  3966. Return sum of any number of arguments, which are numbers or markers.F-
  3967. Negate number or subtract numbers or markers.
  3968. With one arg, negates it.  With more than one arg,
  3969. subtracts all but the first from the first.F*
  3970. Returns product of any number of arguments, which are numbers or markers.F/
  3971. Returns first argument divided by all the remaining arguments.
  3972. The arguments must be numbers or markers.F%
  3973. Returns remainder of X divided by Y.
  3974. Both must be integers or markers.
  3975.  
  3976. (% X Y)Fmod
  3977. Returns X modulo Y.
  3978. The result falls between zero (inclusive) and Y (exclusive).
  3979. Both X and Y must be numbers or markers.
  3980.  
  3981. (mod X Y)Fmax
  3982. Return largest of all the arguments (which must be numbers or markers).
  3983. The value is always a number; markers are converted to numbers.Fmin
  3984. Return smallest of all the arguments (which must be numbers or markers).
  3985. The value is always a number; markers are converted to numbers.Flogand
  3986. Return bitwise-and of all the arguments.
  3987. Arguments may be integers, or markers converted to integers.Flogior
  3988. Return bitwise-or of all the arguments.
  3989. Arguments may be integers, or markers converted to integers.Flogxor
  3990. Return bitwise-exclusive-or of all the arguments.
  3991. Arguments may be integers, or markers converted to integers.Fash
  3992. Return VALUE with its bits shifted left by COUNT.
  3993. If COUNT is negative, shifting is actually to the right.
  3994. In this case, the sign bit is duplicated.
  3995.  
  3996. (ash VALUE COUNT)Flsh
  3997. Return VALUE with its bits shifted left by COUNT.
  3998. If COUNT is negative, shifting is actually to the right.
  3999. In this case,  zeros are shifted in on the left.
  4000.  
  4001. (lsh VALUE COUNT)F1+
  4002. Return NUMBER plus one.  NUMBER may be a number or a marker.
  4003. Markers are converted to integers.
  4004.  
  4005. (1+ NUMBER)F1-
  4006. Return NUMBER minus one.  NUMBER may be a number or a marker.
  4007. Markers are converted to integers.
  4008.  
  4009. (1- NUMBER)Flognot
  4010. Return the bitwise complement of NUMBER.  NUMBER must be an integer.
  4011.  
  4012. (lognot NUMBER)Fdocumentation
  4013. Return the documentation string of FUNCTION.
  4014. Unless a non-nil second argument RAW is given, the
  4015. string is passed through `substitute-command-keys'.
  4016.  
  4017. (documentation FUNCTION &optional RAW)Fdocumentation-property
  4018. Return the documentation string that is SYMBOL's PROP property.
  4019. This is like `get', but it can refer to strings stored in the
  4020. `etc/DOC' file; and if the value is a string, it is passed through
  4021. `substitute-command-keys'.  A non-nil third argument RAW avoids this
  4022. translation.
  4023.  
  4024. (documentation-property SYMBOL PROP &optional RAW)FSnarf-documentation
  4025. Used during Emacs initialization, before dumping runnable Emacs,
  4026. to find pointers to doc strings stored in `etc/DOC...' and
  4027. record them in function definitions.
  4028. One arg, FILENAME, a string which does not include a directory.
  4029. The file is found in `../etc' now; found in the `data-directory'
  4030. when doc strings are referred to later in the dumped Emacs.
  4031.  
  4032. (Snarf-documentation FILENAME)Fsubstitute-command-keys
  4033. Substitute key descriptions for command names in STRING.
  4034. Return a new string which is STRING with substrings of the form \=\[COMMAND]
  4035. replaced by either:  a keystroke sequence that will invoke COMMAND,
  4036. or "M-x COMMAND" if COMMAND is not on any keys.
  4037. Substrings of the form \=\{MAPVAR} are replaced by summaries
  4038. (made by describe-bindings) of the value of MAPVAR, taken as a keymap.
  4039. Substrings of the form \=\<MAPVAR> specify to use the value of MAPVAR
  4040. as the keymap for future \=\[COMMAND] substrings.
  4041. \=\= quotes the following character and is discarded;
  4042. thus, \=\=\=\= puts \=\= into the output, and \=\=\=\[ puts \=\[ into the output.
  4043.  
  4044. (substitute-command-keys STRING)Vinternal-doc-file-name
  4045. Name of file containing documentation strings of built-in symbols.Fchar-to-string
  4046. Convert arg CHARACTER to a one-character string containing that character.
  4047.  
  4048. (char-to-string CHARACTER)Fstring-to-char
  4049. Convert arg STRING to a character, the first character of that string.
  4050.  
  4051. (string-to-char STRING)Fpoint
  4052. Return value of point, as an integer.
  4053. Beginning of buffer is position (point-min)
  4054.  
  4055. (point)Fpoint-marker
  4056. Return value of point, as a marker object.
  4057.  
  4058. (point-marker)Fgoto-char
  4059. Set point to POSITION, a number or marker.
  4060. Beginning of buffer is position (point-min), end is (point-max).
  4061.  
  4062. (goto-char POSITION)Fregion-beginning
  4063. Return position of beginning of region, as an integer.
  4064.  
  4065. (region-beginning)Fregion-end
  4066. Return position of end of region, as an integer.
  4067.  
  4068. (region-end)Fmark-marker
  4069. Return this buffer's mark, as a marker object.
  4070. Watch out!  Moving this marker changes the mark position.
  4071. If you set the marker not to point anywhere, the buffer will have no mark.
  4072.  
  4073. (mark-marker)Fsave-excursion
  4074. Save point, mark, and current buffer; execute BODY; restore those things.
  4075. Executes BODY just like `progn'.
  4076. The values of point, mark and the current buffer are restored
  4077. even in case of abnormal exit (throw or error).
  4078. The state of activation of the mark is also restored.Fbuffer-size
  4079. Return the number of characters in the current buffer.
  4080.  
  4081. (buffer-size)Fpoint-min
  4082. Return the minimum permissible value of point in the current buffer.
  4083. This is 1, unless narrowing (a buffer restriction) is in effect.
  4084.  
  4085. (point-min)Fpoint-min-marker
  4086. Return a marker to the minimum permissible value of point in this buffer.
  4087. This is the beginning, unless narrowing (a buffer restriction) is in effect.
  4088.  
  4089. (point-min-marker)Fpoint-max
  4090. Return the maximum permissible value of point in the current buffer.
  4091. This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
  4092. is in effect, in which case it is less.
  4093.  
  4094. (point-max)Fpoint-max-marker
  4095. Return a marker to the maximum permissible value of point in this buffer.
  4096. This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
  4097. is in effect, in which case it is less.
  4098.  
  4099. (point-max-marker)Ffollowing-char
  4100. Return the character following point, as a number.
  4101. At the end of the buffer or accessible region, return 0.
  4102.  
  4103. (following-char)Fpreceding-char
  4104. Return the character preceding point, as a number.
  4105. At the beginning of the buffer or accessible region, return 0.
  4106.  
  4107. (preceding-char)Fbobp
  4108. Return T if point is at the beginning of the buffer.
  4109. If the buffer is narrowed, this means the beginning of the narrowed part.
  4110.  
  4111. (bobp)Feobp
  4112. Return T if point is at the end of the buffer.
  4113. If the buffer is narrowed, this means the end of the narrowed part.
  4114.  
  4115. (eobp)Fbolp
  4116. Return T if point is at the beginning of a line.
  4117.  
  4118. (bolp)Feolp
  4119. Return T if point is at the end of a line.
  4120. `End of a line' includes point being at the end of the buffer.
  4121.  
  4122. (eolp)Fchar-after
  4123. Return character in current buffer at position POS.
  4124. POS is an integer or a buffer pointer.
  4125. If POS is out of range, the value is nil.
  4126.  
  4127. (char-after POS)Fuser-login-name
  4128. Return the name under which the user logged in, as a string.
  4129. This is based on the effective uid, not the real uid.
  4130. Also, if the environment variable LOGNAME or USER is set,
  4131. that determines the value of this function.
  4132.  
  4133. If optional argument UID is an integer, return the login name of the user
  4134. with that uid, or nil if there is no such user.
  4135.  
  4136. (user-login-name &optional UID)Fuser-real-login-name
  4137. Return the name of the user's real uid, as a string.
  4138. This ignores the environment variables LOGNAME and USER, so it differs from
  4139. `user-login-name' when running under `su'.
  4140.  
  4141. (user-real-login-name)Fuser-uid
  4142. Return the effective uid of Emacs, as an integer.
  4143.  
  4144. (user-uid)Fuser-real-uid
  4145. Return the real uid of Emacs, as an integer.
  4146.  
  4147. (user-real-uid)Fuser-full-name
  4148. Return the full name of the user logged in, as a string.
  4149.  
  4150. (user-full-name)Fsystem-name
  4151. Return the name of the machine you are running on, as a string.
  4152.  
  4153. (system-name)Femacs-pid
  4154. Return the process ID of Emacs, as an integer.
  4155.  
  4156. (emacs-pid)Fcurrent-time
  4157. Return the current time, as the number of seconds since 1970-01-01 00:00:00.
  4158. The time is returned as a list of three integers.  The first has the
  4159. most significant 16 bits of the seconds, while the second has the
  4160. least significant 16 bits.  The third integer gives the microsecond
  4161. count.
  4162.  
  4163. The microsecond count is zero on systems that do not provide
  4164. resolution finer than a second.
  4165.  
  4166. (current-time)Fformat-time-string
  4167. Use FORMAT-STRING to format the time TIME.
  4168. TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as from
  4169. `current-time' and `file-attributes'.
  4170. FORMAT-STRING may contain %-sequences to substitute parts of the time.
  4171. %a is replaced by the abbreviated name of the day of week.
  4172. %A is replaced by the full name of the day of week.
  4173. %b is replaced by the abbreviated name of the month.
  4174. %B is replaced by the full name of the month.
  4175. %c stands for the preferred date/time format of the C locale.
  4176. %d is replaced by the day of month, zero-padded.
  4177. %D is a synonym for "%m/%d/%y".
  4178. %e is replaced by the day of month, blank-padded.
  4179. %h is a synonym for "%b".
  4180. %H is replaced by the hour (00-23).
  4181. %I is replaced by the hour (00-12).
  4182. %j is replaced by the day of the year (001-366).
  4183. %k is replaced by the hour (0-23), blank padded.
  4184. %l is replaced by the hour (1-12), blank padded.
  4185. %m is replaced by the month (01-12).
  4186. %M is replaced by the minute (00-59).
  4187. %n is a synonym for "\n".
  4188. %p is replaced by AM or PM, as appropriate.
  4189. %r is a synonym for "%I:%M:%S %p".
  4190. %R is a synonym for "%H:%M".
  4191. %S is replaced by the second (00-60).
  4192. %t is a synonym for "\t".
  4193. %T is a synonym for "%H:%M:%S".
  4194. %U is replaced by the week of the year (00-53), first day of week is Sunday.
  4195. %w is replaced by the day of week (0-6), Sunday is day 0.
  4196. %W is replaced by the week of the year (00-53), first day of week is Monday.
  4197. %x is a locale-specific synonym, which defaults to "%D" in the C locale.
  4198. %X is a locale-specific synonym, which defaults to "%T" in the C locale.
  4199. %y is replaced by the year without century (00-99).
  4200. %Y is replaced by the year with century.
  4201. %Z is replaced by the time zone abbreviation.
  4202.  
  4203. The number of options reflects the `strftime' function.
  4204.  
  4205. (format-time-string FORMAT-STRING &optional TIME)Fdecode-time
  4206. Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).
  4207. The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)
  4208. or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'
  4209. to use the current time.  The list has the following nine members:
  4210. SEC is an integer between 0 and 60; SEC is 60 for a leap second, which
  4211. only some operating systems support.  MINUTE is an integer between 0 and 59.
  4212. HOUR is an integer between 0 and 23.  DAY is an integer between 1 and 31.
  4213. MONTH is an integer between 1 and 12.  YEAR is an integer indicating the
  4214. four-digit year.  DOW is the day of week, an integer between 0 and 6, where
  4215. 0 is Sunday.  DST is t if daylight savings time is effect, otherwise nil.
  4216. ZONE is an integer indicating the number of seconds east of Greenwich.
  4217. (Note that Common Lisp has different meanings for DOW and ZONE.)
  4218.  
  4219. (decode-time &optional SPECIFIED-TIME)Fencode-time
  4220. Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.
  4221. This is the reverse operation of `decode-time', which see.
  4222. ZONE defaults to the current time zone rule.  This can
  4223. be a string (as from `set-time-zone-rule'), or it can be a list
  4224. (as from `current-time-zone') or an integer (as from `decode-time')
  4225. applied without consideration for daylight savings time.
  4226.  
  4227. You can pass more than 7 arguments; then the first six arguments
  4228. are used as SECOND through YEAR, and the *last* argument is used as ZONE.
  4229. The intervening arguments are ignored.
  4230. This feature lets (apply 'encode-time (decode-time ...)) work.
  4231.  
  4232. Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;
  4233. for example, a DAY of 0 means the day preceding the given month.
  4234. Year numbers less than 100 are treated just like other year numbers.
  4235. If you want them to stand for years in this century, you must do that yourself.Fcurrent-time-string
  4236. Return the current time, as a human-readable string.
  4237. Programs can use this function to decode a time,
  4238. since the number of columns in each field is fixed.
  4239. The format is `Sun Sep 16 01:03:52 1973'.
  4240. If an argument is given, it specifies a time to format
  4241. instead of the current time.  The argument should have the form:
  4242.   (HIGH . LOW)
  4243. or the form:
  4244.   (HIGH LOW . IGNORED).
  4245. Thus, you can use times obtained from `current-time'
  4246. and from `file-attributes'.
  4247.  
  4248. (current-time-string &optional SPECIFIED-TIME)Fcurrent-time-zone
  4249. Return the offset and name for the local time zone.
  4250. This returns a list of the form (OFFSET NAME).
  4251. OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).
  4252.     A negative value means west of Greenwich.
  4253. NAME is a string giving the name of the time zone.
  4254. If an argument is given, it specifies when the time zone offset is determined
  4255. instead of using the current time.  The argument should have the form:
  4256.   (HIGH . LOW)
  4257. or the form:
  4258.   (HIGH LOW . IGNORED).
  4259. Thus, you can use times obtained from `current-time'
  4260. and from `file-attributes'.
  4261.  
  4262. Some operating systems cannot provide all this information to Emacs;
  4263. in this case, `current-time-zone' returns a list containing nil for
  4264. the data it can't find.
  4265.  
  4266. (current-time-zone &optional SPECIFIED-TIME)Fset-time-zone-rule
  4267. Set the local time zone using TZ, a string specifying a time zone rule.
  4268. If TZ is nil, use implementation-defined default time zone information.
  4269.  
  4270. (set-time-zone-rule TZ)Finsert
  4271. Insert the arguments, either strings or characters, at point.
  4272. Point moves forward so that it ends up after the inserted text.
  4273. Any other markers at the point of insertion remain before the text.Finsert-and-inherit
  4274. Insert the arguments at point, inheriting properties from adjoining text.
  4275. Point moves forward so that it ends up after the inserted text.
  4276. Any other markers at the point of insertion remain before the text.Finsert-before-markers
  4277. Insert strings or characters at point, relocating markers after the text.
  4278. Point moves forward so that it ends up after the inserted text.
  4279. Any other markers at the point of insertion also end up after the text.Finsert-before-markers-and-inherit
  4280. Insert text at point, relocating markers and inheriting properties.
  4281. Point moves forward so that it ends up after the inserted text.
  4282. Any other markers at the point of insertion also end up after the text.Finsert-char
  4283. Insert COUNT (second arg) copies of CHARACTER (first arg).
  4284. Point and all markers are affected as in the function `insert'.
  4285. Both arguments are required.
  4286. The optional third arg INHERIT, if non-nil, says to inherit text properties
  4287. from adjoining text, if those properties are sticky.
  4288.  
  4289. (insert-char CHARACTER COUNT &optional INHERIT)Fbuffer-substring
  4290. Return the contents of part of the current buffer as a string.
  4291. The two arguments START and END are character positions;
  4292. they can be in either order.
  4293.  
  4294. (buffer-substring START END)Fbuffer-substring-no-properties
  4295. Return the characters of part of the buffer, without the text properties.
  4296. The two arguments START and END are character positions;
  4297. they can be in either order.
  4298.  
  4299. (buffer-substring-no-properties START END)Fbuffer-string
  4300. Return the contents of the current buffer as a string.
  4301. If narrowing is in effect, this function returns only the visible part
  4302. of the buffer.
  4303.  
  4304. (buffer-string)Finsert-buffer-substring
  4305. Insert before point a substring of the contents of buffer BUFFER.
  4306. BUFFER may be a buffer or a buffer name.
  4307. Arguments START and END are character numbers specifying the substring.
  4308. They default to the beginning and the end of BUFFER.
  4309.  
  4310. (insert-buffer-substring BUF &optional START END)Fcompare-buffer-substrings
  4311. Compare two substrings of two buffers; return result as number.
  4312. the value is -N if first string is less after N-1 chars,
  4313. +N if first string is greater after N-1 chars, or 0 if strings match.
  4314. Each substring is represented as three arguments: BUFFER, START and END.
  4315. That makes six args in all, three for each substring.
  4316.  
  4317. The value of `case-fold-search' in the current buffer
  4318. determines whether case is significant or ignored.
  4319.  
  4320. (compare-buffer-substrings BUFFER1 START1 END1 BUFFER2 START2 END2)Fsubst-char-in-region
  4321. From START to END, replace FROMCHAR with TOCHAR each time it occurs.
  4322. If optional arg NOUNDO is non-nil, don't record this change for undo
  4323. and don't mark the buffer as really changed.
  4324.  
  4325. (subst-char-in-region START END FROMCHAR TOCHAR &optional NOUNDO)Ftranslate-region
  4326. From START to END, translate characters according to TABLE.
  4327. TABLE is a string; the Nth character in it is the mapping
  4328. for the character with code N.  Returns the number of characters changed.
  4329.  
  4330. (translate-region START END TABLE)Fdelete-region
  4331. Delete the text between point and mark.
  4332. When called from a program, expects two arguments,
  4333. positions (integers or markers) specifying the stretch to be deleted.
  4334.  
  4335. (delete-region START END)Fwiden
  4336. Remove restrictions (narrowing) from current buffer.
  4337. This allows the buffer's full text to be seen and edited.
  4338.  
  4339. (widen)Fnarrow-to-region
  4340. Restrict editing in this buffer to the current region.
  4341. The rest of the text becomes temporarily invisible and untouchable
  4342. but is not deleted; if you save the buffer in a file, the invisible
  4343. text is included in the file.  \[widen] makes all visible again.
  4344. See also `save-restriction'.
  4345.  
  4346. When calling from a program, pass two arguments; positions (integers
  4347. or markers) bounding the text that should remain visible.
  4348.  
  4349. (narrow-to-region START END)Fsave-restriction
  4350. Execute BODY, saving and restoring current buffer's restrictions.
  4351. The buffer's restrictions make parts of the beginning and end invisible.
  4352. (They are set up with `narrow-to-region' and eliminated with `widen'.)
  4353. This special form, `save-restriction', saves the current buffer's restrictions
  4354. when it is entered, and restores them when it is exited.
  4355. So any `narrow-to-region' within BODY lasts only until the end of the form.
  4356. The old restrictions settings are restored
  4357. even in case of abnormal exit (throw or error).
  4358.  
  4359. The value returned is the value of the last form in BODY.
  4360.  
  4361. `save-restriction' can get confused if, within the BODY, you widen
  4362. and then make changes outside the area within the saved restrictions.
  4363.  
  4364. Note: if you are using both `save-excursion' and `save-restriction',
  4365. use `save-excursion' outermost:
  4366.     (save-excursion (save-restriction ...))Fmessage
  4367. Print a one-line message at the bottom of the screen.
  4368. The first argument is a format control string, and the rest are data
  4369. to be formatted under control of the string.  See `format' for details.
  4370.  
  4371. If the first argument is nil, clear any existing message; let the
  4372. minibuffer contents show.Fmessage-box
  4373. Display a message, in a dialog box if possible.
  4374. If a dialog box is not available, use the echo area.
  4375. The first argument is a format control string, and the rest are data
  4376. to be formatted under control of the string.  See `format' for details.
  4377.  
  4378. If the first argument is nil, clear any existing message; let the
  4379. minibuffer contents show.Fmessage-or-box
  4380. Display a message in a dialog box or in the echo area.
  4381. If this command was invoked with the mouse, use a dialog box.
  4382. Otherwise, use the echo area.
  4383. The first argument is a format control string, and the rest are data
  4384. to be formatted under control of the string.  See `format' for details.
  4385.  
  4386. If the first argument is nil, clear any existing message; let the
  4387. minibuffer contents show.Fformat
  4388. Format a string out of a control-string and arguments.
  4389. The first argument is a control string.
  4390. The other arguments are substituted into it to make the result, a string.
  4391. It may contain %-sequences meaning to substitute the next argument.
  4392. %s means print a string argument.  Actually, prints any object, with `princ'.
  4393. %d means print as number in decimal (%o octal, %x hex).
  4394. %e means print a number in exponential notation.
  4395. %f means print a number in decimal-point notation.
  4396. %g means print a number in exponential notation
  4397.   or decimal-point notation, whichever uses fewer characters.
  4398. %c means print a number as a single character.
  4399. %S means print any object as an s-expression (using prin1).
  4400.   The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.
  4401. Use %% to put a single % into the output.Fchar-equal
  4402. Return t if two characters match, optionally ignoring case.
  4403. Both arguments must be characters (i.e. integers).
  4404. Case is ignored if `case-fold-search' is non-nil in the current buffer.
  4405.  
  4406. (char-equal C1 C2)Ftranspose-regions
  4407. Transpose region START1 to END1 with START2 to END2.
  4408. The regions may not be overlapping, because the size of the buffer is
  4409. never changed in a transposition.
  4410.  
  4411. Optional fifth arg LEAVE_MARKERS, if non-nil, means don't transpose
  4412. any markers that happen to be located in the regions.
  4413.  
  4414. Transposing beyond buffer boundaries is an error.
  4415.  
  4416. (transpose-regions STARTR1 ENDR1 STARTR2 ENDR2 &optional LEAVE-MARKERS)Vbuffer-access-fontify-functions
  4417. List of functions called by `buffer-substring' to fontify if necessary.
  4418. Each function is called with two arguments which specify the range
  4419. of the buffer being accessed.Vbuffer-access-fontified-property
  4420. Property which (if non-nil) indicates text has been fontified.
  4421. `buffer-substring' need not call the `buffer-access-fontify-functions'
  4422. functions if all the text being accessed has this property.Vsystem-name
  4423. The name of the machine Emacs is running on.Vuser-full-name
  4424. The full name of the user logged in.Vuser-login-name
  4425. The user's name, taken from environment variables if possible.Vuser-real-login-name
  4426. The user's name, based upon the real uid only.Finteractive
  4427. Specify a way of parsing arguments for interactive use of a function.
  4428. For example, write
  4429.   (defun foo (arg) "Doc string" (interactive "p") ...use arg...)
  4430. to make ARG be the prefix argument when `foo' is called as a command.
  4431. The "call" to `interactive' is actually a declaration rather than a function;
  4432.  it tells `call-interactively' how to read arguments
  4433.  to pass to the function.
  4434. When actually called, `interactive' just returns nil.
  4435.  
  4436. The argument of `interactive' is usually a string containing a code letter
  4437.  followed by a prompt.  (Some code letters do not use I/O to get
  4438.  the argument and do not need prompts.)  To prompt for multiple arguments,
  4439.  give a code letter, its prompt, a newline, and another code letter, etc.
  4440.  Prompts are passed to format, and may use % escapes to print the
  4441.  arguments that have already been read.
  4442. If the argument is not a string, it is evaluated to get a list of
  4443.  arguments to pass to the function.
  4444. Just `(interactive)' means pass no args when calling interactively.
  4445.  
  4446. Code letters available are:
  4447. a -- Function name: symbol with a function definition.
  4448. b -- Name of existing buffer.
  4449. B -- Name of buffer, possibly nonexistent.
  4450. c -- Character.
  4451. C -- Command name: symbol with interactive function definition.
  4452. d -- Value of point as number.  Does not do I/O.
  4453. D -- Directory name.
  4454. e -- Parametrized event (i.e., one that's a list) that invoked this command.
  4455.      If used more than once, the Nth `e' returns the Nth parameterized event.
  4456.      This skips events that are integers or symbols.
  4457. f -- Existing file name.
  4458. F -- Possibly nonexistent file name.
  4459. k -- Key sequence (downcase the last event if needed to get a definition).
  4460. K -- Key sequence to be redefined (do not downcase the last event).
  4461. m -- Value of mark as number.  Does not do I/O.
  4462. n -- Number read using minibuffer.
  4463. N -- Raw prefix arg, or if none, do like code `n'.
  4464. p -- Prefix arg converted to number.  Does not do I/O.
  4465. P -- Prefix arg in raw form.  Does not do I/O.
  4466. r -- Region: point and mark as 2 numeric args, smallest first.  Does no I/O.
  4467. s -- Any string.
  4468. S -- Any symbol.
  4469. v -- Variable name: symbol that is user-variable-p.
  4470. x -- Lisp expression read but not evaluated.
  4471. X -- Lisp expression read and evaluated.
  4472. In addition, if the string begins with `*'
  4473.  then an error is signaled if the buffer is read-only.
  4474.  This happens before reading any arguments.
  4475. If the string begins with `@', then Emacs searches the key sequence
  4476.  which invoked the command for its first mouse click (or any other
  4477.  event which specifies a window), and selects that window before
  4478.  reading any arguments.  You may use both `@' and `*'; they are
  4479.  processed in the order that they appear.
  4480.  
  4481. (interactive ARGS)Fcall-interactively
  4482. Call FUNCTION, reading args according to its interactive calling specs.
  4483. Return the value FUNCTION returns.
  4484. The function contains a specification of how to do the argument reading.
  4485. In the case of user-defined functions, this is specified by placing a call
  4486. to the function `interactive' at the top level of the function body.
  4487. See `interactive'.
  4488.  
  4489. Optional second arg RECORD-FLAG non-nil
  4490. means unconditionally put this command in the command-history.
  4491. Otherwise, this is done only if an arg is read using the minibuffer.
  4492.  
  4493. (call-interactively FUNCTION &optional RECORD-FLAG KEYS)Fprefix-numeric-value
  4494. Return numeric meaning of raw prefix argument RAW.
  4495. A raw prefix argument is what you get from `(interactive "P")'.
  4496. Its numeric meaning is what you would get from `(interactive "p")'.
  4497.  
  4498. (prefix-numeric-value RAW)Vprefix-arg
  4499. The value of the prefix argument for the next editing command.
  4500. It may be a number, or the symbol `-' for just a minus sign as arg,
  4501. or a list whose car is a number for just one or more C-U's
  4502. or nil if no argument has been specified.
  4503.  
  4504. You cannot examine this variable to find the argument for this command
  4505. since it has been set to nil by the time you can look.
  4506. Instead, you should use the variable `current-prefix-arg', although
  4507. normally commands can get this prefix argument with (interactive "P").Vcurrent-prefix-arg
  4508. The value of the prefix argument for this editing command.
  4509. It may be a number, or the symbol `-' for just a minus sign as arg,
  4510. or a list whose car is a number for just one or more C-U's
  4511. or nil if no argument has been specified.
  4512. This is what `(interactive "P")' returns.Vcommand-history
  4513. List of recent commands that read arguments from terminal.
  4514. Each command is represented as a form to evaluate.Vcommand-debug-status
  4515. Debugging status of current interactive command.
  4516. Bound each time `call-interactively' is called;
  4517. may be set by the debugger as a reminder for itself.Vmark-even-if-inactive
  4518. *Non-nil means you can use the mark even when inactive.
  4519. This option makes a difference in Transient Mark mode.
  4520. When the option is non-nil, deactivation of the mark
  4521. turns off region highlighting, but commands that use the mark
  4522. behave as if the mark were still active.Vmouse-leave-buffer-hook
  4523. Hook to run when about to switch windows with a mouse command.
  4524. Its purpose is to give temporary modes such as Isearch mode
  4525. a way to turn themselves off when a mouse command switches windows.For
  4526. Eval args until one of them yields non-nil, then return that value.
  4527. The remaining args are not evalled at all.
  4528. If all args return nil, return nil.Fand
  4529. Eval args until one of them yields nil, then return nil.
  4530. The remaining args are not evalled at all.
  4531. If no arg yields nil, return the last arg's value.Fif
  4532. (if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...
  4533. Returns the value of THEN or the value of the last of the ELSE's.
  4534. THEN must be one expression, but ELSE... can be zero or more expressions.
  4535. If COND yields nil, and there are no ELSE's, the value is nil.Fcond
  4536. (cond CLAUSES...): try each clause until one succeeds.
  4537. Each clause looks like (CONDITION BODY...).  CONDITION is evaluated
  4538. and, if the value is non-nil, this clause succeeds:
  4539. then the expressions in BODY are evaluated and the last one's
  4540. value is the value of the cond-form.
  4541. If no clause succeeds, cond returns nil.
  4542. If a clause has one element, as in (CONDITION),
  4543. CONDITION's value if non-nil is returned from the cond-form.Fprogn
  4544. (progn BODY...): eval BODY forms sequentially and return value of last one.Fprog1
  4545. (prog1 FIRST BODY...): eval FIRST and BODY sequentially; value from FIRST.
  4546. The value of FIRST is saved during the evaluation of the remaining args,
  4547. whose values are discarded.Fprog2
  4548. (prog2 X Y BODY...): eval X, Y and BODY sequentially; value from Y.
  4549. The value of Y is saved during the evaluation of the remaining args,
  4550. whose values are discarded.Fsetq
  4551. (setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.
  4552. The symbols SYM are variables; they are literal (not evaluated).
  4553. The values VAL are expressions; they are evaluated.
  4554. Thus, (setq x (1+ y)) sets `x' to the value of `(1+ y)'.
  4555. The second VAL is not computed until after the first SYM is set, and so on;
  4556. each VAL can use the new value of variables set earlier in the `setq'.
  4557. The return value of the `setq' form is the value of the last VAL.Fquote
  4558. Return the argument, without evaluating it.  `(quote x)' yields `x'.Ffunction
  4559. Like `quote', but preferred for objects which are functions.
  4560. In byte compilation, `function' causes its argument to be compiled.
  4561. `quote' cannot do that.Finteractive-p
  4562. Return t if function in which this appears was called interactively.
  4563. This means that the function was called with call-interactively (which
  4564. includes being called as the binding of a key)
  4565. and input is currently coming from the keyboard (not in keyboard macro).
  4566.  
  4567. (interactive-p)Fdefun
  4568. (defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.
  4569. The definition is (lambda ARGLIST [DOCSTRING] BODY...).
  4570. See also the function `interactive'.Fdefmacro
  4571. (defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.
  4572. The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).
  4573. When the macro is called, as in (NAME ARGS...),
  4574. the function (lambda ARGLIST BODY...) is applied to
  4575. the list ARGS... as it appears in the expression,
  4576. and the result should be a form to be evaluated instead of the original.Fdefvar
  4577. (defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.
  4578. You are not required to define a variable in order to use it,
  4579. but the definition can supply documentation and an initial value
  4580. in a way that tags can recognize.
  4581.  
  4582. INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.
  4583. If SYMBOL is buffer-local, its default value is what is set;
  4584.  buffer-local values are not affected.
  4585. INITVALUE and DOCSTRING are optional.
  4586. If DOCSTRING starts with *, this variable is identified as a user option.
  4587.  This means that M-x set-variable and M-x edit-options recognize it.
  4588. If INITVALUE is missing, SYMBOL's value is not set.Fdefconst
  4589. (defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant variable.
  4590. The intent is that programs do not change this value, but users may.
  4591. Always sets the value of SYMBOL to the result of evalling INITVALUE.
  4592. If SYMBOL is buffer-local, its default value is what is set;
  4593.  buffer-local values are not affected.
  4594. DOCSTRING is optional.
  4595. If DOCSTRING starts with *, this variable is identified as a user option.
  4596.  This means that M-x set-variable and M-x edit-options recognize it.
  4597.  
  4598. Note: do not use `defconst' for user options in libraries that are not
  4599. normally loaded, since it is useful for users to be able to specify
  4600. their own values for such variables before loading the library.
  4601. Since `defconst' unconditionally assigns the variable,
  4602. it would override the user's choice.Fuser-variable-p
  4603. Returns t if VARIABLE is intended to be set and modified by users.
  4604. (The alternative is a variable used internally in a Lisp program.)
  4605. Determined by whether the first character of the documentation
  4606. for the variable is `*'.
  4607.  
  4608. (user-variable-p VARIABLE)Flet*
  4609. (let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  4610. The value of the last form in BODY is returned.
  4611. Each element of VARLIST is a symbol (which is bound to nil)
  4612. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  4613. Each VALUEFORM can refer to the symbols already bound by this VARLIST.Flet
  4614. (let VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  4615. The value of the last form in BODY is returned.
  4616. Each element of VARLIST is a symbol (which is bound to nil)
  4617. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  4618. All the VALUEFORMs are evalled before any symbols are bound.Fwhile
  4619. (while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.
  4620. The order of execution is thus TEST, BODY, TEST, BODY and so on
  4621. until TEST returns nil.Fmacroexpand
  4622. Return result of expanding macros at top level of FORM.
  4623. If FORM is not a macro call, it is returned unchanged.
  4624. Otherwise, the macro is expanded and the expansion is considered
  4625. in place of FORM.  When a non-macro-call results, it is returned.
  4626.  
  4627. The second optional arg ENVIRONMENT species an environment of macro
  4628. definitions to shadow the loaded ones for use in file byte-compilation.
  4629.  
  4630. (macroexpand FORM &optional ENVIRONMENT)Fcatch
  4631. (catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.
  4632. TAG is evalled to get the tag to use.  Then the BODY is executed.
  4633. Within BODY, (throw TAG) with same tag exits BODY and exits this `catch'.
  4634. If no throw happens, `catch' returns the value of the last BODY form.
  4635. If a throw happens, it specifies the value to return from `catch'.Fthrow
  4636. (throw TAG VALUE): throw to the catch for TAG and return VALUE from it.
  4637. Both TAG and VALUE are evalled.
  4638.  
  4639. (throw TAG VALUE)Funwind-protect
  4640. Do BODYFORM, protecting with UNWINDFORMS.
  4641. Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).
  4642. If BODYFORM completes normally, its value is returned
  4643. after executing the UNWINDFORMS.
  4644. If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.Fcondition-case
  4645. Regain control when an error is signaled.
  4646. Usage looks like (condition-case VAR BODYFORM HANDLERS...).
  4647. executes BODYFORM and returns its value if no error happens.
  4648. Each element of HANDLERS looks like (CONDITION-NAME BODY...)
  4649. where the BODY is made of Lisp expressions.
  4650.  
  4651. A handler is applicable to an error
  4652. if CONDITION-NAME is one of the error's condition names.
  4653. If an error happens, the first applicable handler is run.
  4654.  
  4655. The car of a handler may be a list of condition names
  4656. instead of a single condition name.
  4657.  
  4658. When a handler handles an error,
  4659. control returns to the condition-case and the handler BODY... is executed
  4660. with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).
  4661. VAR may be nil; then you do not get access to the signal information.
  4662.  
  4663. The value of the last BODY form is returned from the condition-case.
  4664. See also the function `signal' for more info.Fsignal
  4665. Signal an error.  Args are ERROR-SYMBOL and associated DATA.
  4666. This function does not return.
  4667.  
  4668. An error symbol is a symbol with an `error-conditions' property
  4669. that is a list of condition names.
  4670. A handler for any of those names will get to handle this signal.
  4671. The symbol `error' should normally be one of them.
  4672.  
  4673. DATA should be a list.  Its elements are printed as part of the error message.
  4674. If the signal is handled, DATA is made available to the handler.
  4675. See also the function `condition-case'.
  4676.  
  4677. (signal ERROR-SYMBOL DATA)Fcommandp
  4678. T if FUNCTION makes provisions for interactive calling.
  4679. This means it contains a description for how to read arguments to give it.
  4680. The value is nil for an invalid function or a symbol with no function
  4681. definition.
  4682.  
  4683. Interactively callable functions include strings and vectors (treated
  4684. as keyboard macros), lambda-expressions that contain a top-level call
  4685. to `interactive', autoload definitions made by `autoload' with non-nil
  4686. fourth argument, and some of the built-in functions of Lisp.
  4687.  
  4688. Also, a symbol satisfies `commandp' if its function definition does so.
  4689.  
  4690. (commandp FUNCTION)Fautoload
  4691. Define FUNCTION to autoload from FILE.
  4692. FUNCTION is a symbol; FILE is a file name string to pass to `load'.
  4693. Third arg DOCSTRING is documentation for the function.
  4694. Fourth arg INTERACTIVE if non-nil says function can be called interactively.
  4695. Fifth arg TYPE indicates the type of the object:
  4696.    nil or omitted says FUNCTION is a function,
  4697.    `keymap' says FUNCTION is really a keymap, and
  4698.    `macro' or t says FUNCTION is really a macro.
  4699. Third through fifth args give info about the real definition.
  4700. They default to nil.
  4701. If FUNCTION is already defined other than as an autoload,
  4702. this does nothing and returns nil.
  4703.  
  4704. (autoload FUNCTION FILE &optional DOCSTRING INTERACTIVE TYPE)Feval
  4705. Evaluate FORM and return its value.
  4706.  
  4707. (eval FORM)Fapply
  4708. Call FUNCTION with our remaining args, using our last arg as list of args.
  4709. Then return the value FUNCTION returns.
  4710. Thus, (apply '+ 1 2 '(3 4)) returns 10.Frun-hooks
  4711. Run each hook in HOOKS.  Major mode functions use this.
  4712. Each argument should be a symbol, a hook variable.
  4713. These symbols are processed in the order specified.
  4714. If a hook symbol has a non-nil value, that value may be a function
  4715. or a list of functions to be called to run the hook.
  4716. If the value is a function, it is called with no arguments.
  4717. If it is a list, the elements are called, in order, with no arguments.
  4718.  
  4719. To make a hook variable buffer-local, use `make-local-hook',
  4720. not `make-local-variable'.Frun-hook-with-args
  4721. Run HOOK with the specified arguments ARGS.
  4722. HOOK should be a symbol, a hook variable.  If HOOK has a non-nil
  4723. value, that value may be a function or a list of functions to be
  4724. called to run the hook.  If the value is a function, it is called with
  4725. the given arguments and its return value is returned.  If it is a list
  4726. of functions, those functions are called, in order,
  4727. with the given arguments ARGS.
  4728. It is best not to depend on the value return by `run-hook-with-args',
  4729. as that may change.
  4730.  
  4731. To make a hook variable buffer-local, use `make-local-hook',
  4732. not `make-local-variable'.Frun-hook-with-args-until-success
  4733. Run HOOK with the specified arguments ARGS.
  4734. HOOK should be a symbol, a hook variable.  Its value should
  4735. be a list of functions.  We call those functions, one by one,
  4736. passing arguments ARGS to each of them, until one of them
  4737. returns a non-nil value.  Then we return that value.
  4738. If all the functions return nil, we return nil.
  4739.  
  4740. To make a hook variable buffer-local, use `make-local-hook',
  4741. not `make-local-variable'.Frun-hook-with-args-until-failure
  4742. Run HOOK with the specified arguments ARGS.
  4743. HOOK should be a symbol, a hook variable.  Its value should
  4744. be a list of functions.  We call those functions, one by one,
  4745. passing arguments ARGS to each of them, until one of them
  4746. returns nil.  Then we return nil.
  4747. If all the functions return non-nil, we return non-nil.
  4748.  
  4749. To make a hook variable buffer-local, use `make-local-hook',
  4750. not `make-local-variable'.Ffuncall
  4751. Call first argument as a function, passing remaining arguments to it.
  4752. Return the value that function returns.
  4753. Thus, (funcall 'cons 'x 'y) returns (x . y).Ffetch-bytecode
  4754. If byte-compiled OBJECT is lazy-loaded, fetch it now.
  4755.  
  4756. (fetch-bytecode OBJECT)Fbacktrace-debug
  4757. Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
  4758. The debugger is entered when that frame exits, if the flag is non-nil.
  4759.  
  4760. (backtrace-debug LEVEL FLAG)Fbacktrace
  4761. Print a trace of Lisp function calls currently active.
  4762. Output stream used is value of `standard-output'.
  4763.  
  4764. (backtrace)Fbacktrace-frame
  4765. Return the function and arguments NFRAMES up from current execution point.
  4766. If that frame has not evaluated the arguments yet (or is a special form),
  4767. the value is (nil FUNCTION ARG-FORMS...).
  4768. If that frame has evaluated its arguments and called its function already,
  4769. the value is (t FUNCTION ARG-VALUES...).
  4770. A &rest arg is represented as the tail of the list ARG-VALUES.
  4771. FUNCTION is whatever was supplied as car of evaluated list,
  4772. or a lambda expression for macro calls.
  4773. If NFRAMES is more than the number of frames, the value is nil.
  4774.  
  4775. (backtrace-frame NFRAMES)Vmax-specpdl-size
  4776. Limit on number of Lisp variable bindings & unwind-protects before error.Vmax-lisp-eval-depth
  4777. Limit on depth in `eval', `apply' and `funcall' before error.
  4778. This limit is to catch infinite recursions for you before they cause
  4779. actual stack overflow in C, which would be fatal for Emacs.
  4780. You can safely make it considerably larger than its default value,
  4781. if that proves inconveniently small.Vquit-flag
  4782. Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
  4783. Typing C-g sets `quit-flag' non-nil, regardless of `inhibit-quit'.Vinhibit-quit
  4784. Non-nil inhibits C-g quitting from happening immediately.
  4785. Note that `quit-flag' will still be set by typing C-g,
  4786. so a quit will be signaled as soon as `inhibit-quit' is nil.
  4787. To prevent this happening, set `quit-flag' to nil
  4788. before making `inhibit-quit' nil.Vstack-trace-on-error
  4789. *Non-nil means automatically display a backtrace buffer
  4790. after any error that is handled by the editor command loop.
  4791. If the value is a list, an error only means to display a backtrace
  4792. if one of its condition symbols appears in the list.Vdebug-on-error
  4793. *Non-nil means enter debugger if an error is signaled.
  4794. Does not apply to errors handled by `condition-case'.
  4795. If the value is a list, an error only means to enter the debugger
  4796. if one of its condition symbols appears in the list.
  4797. See also variable `debug-on-quit'.Vdebug-ignored-errors
  4798. *List of errors for which the debugger should not be called.
  4799. Each element may be a condition-name or a regexp that matches error messages.
  4800. If any element applies to a given error, that error skips the debugger
  4801. and just returns to top level.
  4802. This overrides the variable `debug-on-error'.
  4803. It does not apply to errors handled by `condition-case'.Vdebug-on-quit
  4804. *Non-nil means enter debugger if quit is signaled (C-g, for example).
  4805. Does not apply if quit is handled by a `condition-case'.Vdebug-on-next-call
  4806. Non-nil means enter debugger before next `eval', `apply' or `funcall'.Vdebugger
  4807. Function to call to invoke debugger.
  4808. If due to frame exit, args are `exit' and the value being returned;
  4809.  this function's value will be returned instead of that.
  4810. If due to error, args are `error' and a list of the args to `signal'.
  4811. If due to `apply' or `funcall' entry, one arg, `lambda'.
  4812. If due to `eval' entry, one arg, t.Vmocklisp-arguments
  4813. While in a mocklisp function, the list of its unevaluated args.Vrun-hooks
  4814. Set to the function `run-hooks', if that function has been defined.
  4815. Otherwise, nil (in a bare Emacs without preloaded Lisp code).Facos
  4816. Return the inverse cosine of ARG.
  4817.  
  4818. (acos ARG)Fasin
  4819. Return the inverse sine of ARG.
  4820.  
  4821. (asin ARG)Fatan
  4822. Return the inverse tangent of ARG.
  4823.  
  4824. (atan ARG)Fcos
  4825. Return the cosine of ARG.
  4826.  
  4827. (cos ARG)Fsin
  4828. Return the sine of ARG.
  4829.  
  4830. (sin ARG)Ftan
  4831. Return the tangent of ARG.
  4832.  
  4833. (tan ARG)Fbessel-j0
  4834. Return the bessel function j0 of ARG.
  4835.  
  4836. (bessel-j0 ARG)Fbessel-j1
  4837. Return the bessel function j1 of ARG.
  4838.  
  4839. (bessel-j1 ARG)Fbessel-jn
  4840. Return the order N bessel function output jn of ARG.
  4841. The first arg (the order) is truncated to an integer.
  4842.  
  4843. (bessel-jn N ARG)Fbessel-y0
  4844. Return the bessel function y0 of ARG.
  4845.  
  4846. (bessel-y0 ARG)Fbessel-y1
  4847. Return the bessel function y1 of ARG.
  4848.  
  4849. (bessel-y1 ARG)Fbessel-yn
  4850. Return the order N bessel function output yn of ARG.
  4851. The first arg (the order) is truncated to an integer.
  4852.  
  4853. (bessel-yn N ARG)Ferf
  4854. Return the mathematical error function of ARG.
  4855.  
  4856. (erf ARG)Ferfc
  4857. Return the complementary error function of ARG.
  4858.  
  4859. (erfc ARG)Flog-gamma
  4860. Return the log gamma of ARG.
  4861.  
  4862. (log-gamma ARG)Fcube-root
  4863. Return the cube root of ARG.
  4864.  
  4865. (cube-root ARG)Fexp
  4866. Return the exponential base e of ARG.
  4867.  
  4868. (exp ARG)Fexpt
  4869. Return the exponential ARG1 ** ARG2.
  4870.  
  4871. (expt ARG1 ARG2)Flog
  4872. Return the natural logarithm of ARG.
  4873. If second optional argument BASE is given, return log ARG using that base.
  4874.  
  4875. (log ARG &optional BASE)Flog10
  4876. Return the logarithm base 10 of ARG.
  4877.  
  4878. (log10 ARG)Fsqrt
  4879. Return the square root of ARG.
  4880.  
  4881. (sqrt ARG)Facosh
  4882. Return the inverse hyperbolic cosine of ARG.
  4883.  
  4884. (acosh ARG)Fasinh
  4885. Return the inverse hyperbolic sine of ARG.
  4886.  
  4887. (asinh ARG)Fatanh
  4888. Return the inverse hyperbolic tangent of ARG.
  4889.  
  4890. (atanh ARG)Fcosh
  4891. Return the hyperbolic cosine of ARG.
  4892.  
  4893. (cosh ARG)Fsinh
  4894. Return the hyperbolic sine of ARG.
  4895.  
  4896. (sinh ARG)Ftanh
  4897. Return the hyperbolic tangent of ARG.
  4898.  
  4899. (tanh ARG)Fabs
  4900. Return the absolute value of ARG.
  4901.  
  4902. (abs ARG)Ffloat
  4903. Return the floating point number equal to ARG.
  4904.  
  4905. (float ARG)Flogb
  4906. Returns largest integer <= the base 2 log of the magnitude of ARG.
  4907. This is the same as the exponent of a float.
  4908.  
  4909. (logb ARG)Fceiling
  4910. Return the smallest integer no less than ARG.  (Round toward +inf.)
  4911.  
  4912. (ceiling ARG)Ffloor
  4913. Return the largest integer no greater than ARG.  (Round towards -inf.)
  4914. With optional DIVISOR, return the largest integer no greater than ARG/DIVISOR.
  4915.  
  4916. (floor ARG &optional DIVISOR)Fround
  4917. Return the nearest integer to ARG.
  4918.  
  4919. (round ARG)Ftruncate
  4920. Truncate a floating point number to an int.
  4921. Rounds the value toward zero.
  4922.  
  4923. (truncate ARG)Ffceiling
  4924. Return the smallest integer no less than ARG, as a float.
  4925. (Round toward +inf.)
  4926.  
  4927. (fceiling ARG)Fffloor
  4928. Return the largest integer no greater than ARG, as a float.
  4929. (Round towards -inf.)
  4930.  
  4931. (ffloor ARG)Ffround
  4932. Return the nearest integer to ARG, as a float.
  4933.  
  4934. (fround ARG)Fftruncate
  4935. Truncate a floating point number to an integral float value.
  4936. Rounds the value toward zero.
  4937.  
  4938. (ftruncate ARG)Fidentity
  4939. Return the argument unchanged.
  4940.  
  4941. (identity ARG)Frandom
  4942. Return a pseudo-random number.
  4943. All integers representable in Lisp are equally likely.
  4944.   On most systems, this is 28 bits' worth.
  4945. With positive integer argument N, return random number in interval [0,N).
  4946. With argument t, set the random number seed from the current time and pid.
  4947.  
  4948. (random &optional N)Flength
  4949. Return the length of vector, list or string SEQUENCE.
  4950. A byte-code function object is also allowed.
  4951.  
  4952. (length SEQUENCE)Fsafe-length
  4953. Return the length of a list, but avoid error or infinite loop.
  4954. This function never gets an error.  If LIST is not really a list,
  4955. it returns 0.  If LIST is circular, it returns a finite value
  4956. which is at least the number of distinct elements.
  4957.  
  4958. (safe-length LIST)Fstring-equal
  4959. T if two strings have identical contents.
  4960. Case is significant, but text properties are ignored.
  4961. Symbols are also allowed; their print names are used instead.
  4962.  
  4963. (string-equal S1 S2)Fstring-lessp
  4964. T if first arg string is less than second in lexicographic order.
  4965. Case is significant.
  4966. Symbols are also allowed; their print names are used instead.
  4967.  
  4968. (string-lessp S1 S2)Fappend
  4969. Concatenate all the arguments and make the result a list.
  4970. The result is a list whose elements are the elements of all the arguments.
  4971. Each argument may be a list, vector or string.
  4972. The last argument is not copied, just used as the tail of the new list.Fconcat
  4973. Concatenate all the arguments and make the result a string.
  4974. The result is a string whose elements are the elements of all the arguments.
  4975. Each argument may be a string or a list or vector of characters (integers).
  4976.  
  4977. Do not use individual integers as arguments!
  4978. The behavior of `concat' in that case will be changed later!
  4979. If your program passes an integer as an argument to `concat',
  4980. you should change it right away not to do so.Fvconcat
  4981. Concatenate all the arguments and make the result a vector.
  4982. The result is a vector whose elements are the elements of all the arguments.
  4983. Each argument may be a list, vector or string.Fcopy-sequence
  4984. Return a copy of a list, vector or string.
  4985. The elements of a list or vector are not copied; they are shared
  4986. with the original.
  4987.  
  4988. (copy-sequence ARG)Fcopy-alist
  4989. Return a copy of ALIST.
  4990. This is an alist which represents the same mapping from objects to objects,
  4991. but does not share the alist structure with ALIST.
  4992. The objects mapped (cars and cdrs of elements of the alist)
  4993. are shared, however.
  4994. Elements of ALIST that are not conses are also shared.
  4995.  
  4996. (copy-alist ALIST)Fsubstring
  4997. Return a substring of STRING, starting at index FROM and ending before TO.
  4998. TO may be nil or omitted; then the substring runs to the end of STRING.
  4999. If FROM or TO is negative, it counts from the end.
  5000.  
  5001. (substring STRING FROM &optional TO)Fnthcdr
  5002. Take cdr N times on LIST, returns the result.
  5003.  
  5004. (nthcdr N LIST)Fnth
  5005. Return the Nth element of LIST.
  5006. N counts from zero.  If LIST is not that long, nil is returned.
  5007.  
  5008. (nth N LIST)Felt
  5009. Return element of SEQUENCE at index N.
  5010.  
  5011. (elt SEQUENCE N)Fmember
  5012. Return non-nil if ELT is an element of LIST.  Comparison done with `equal'.
  5013. The value is actually the tail of LIST whose car is ELT.
  5014.  
  5015. (member ELT LIST)Fmemq
  5016. Return non-nil if ELT is an element of LIST.  Comparison done with EQ.
  5017. The value is actually the tail of LIST whose car is ELT.
  5018.  
  5019. (memq ELT LIST)Fassq
  5020. Return non-nil if KEY is `eq' to the car of an element of LIST.
  5021. The value is actually the element of LIST whose car is KEY.
  5022. Elements of LIST that are not conses are ignored.
  5023.  
  5024. (assq KEY LIST)Fassoc
  5025. Return non-nil if KEY is `equal' to the car of an element of LIST.
  5026. The value is actually the element of LIST whose car equals KEY.
  5027.  
  5028. (assoc KEY LIST)Frassq
  5029. Return non-nil if ELT is `eq' to the cdr of an element of LIST.
  5030. The value is actually the element of LIST whose cdr is ELT.
  5031.  
  5032. (rassq KEY LIST)Frassoc
  5033. Return non-nil if KEY is `equal' to the cdr of an element of LIST.
  5034. The value is actually the element of LIST whose cdr equals KEY.
  5035.  
  5036. (rassoc KEY LIST)Fdelq
  5037. Delete by side effect any occurrences of ELT as a member of LIST.
  5038. The modified LIST is returned.  Comparison is done with `eq'.
  5039. If the first member of LIST is ELT, there is no way to remove it by side effect;
  5040. therefore, write `(setq foo (delq element foo))'
  5041. to be sure of changing the value of `foo'.
  5042.  
  5043. (delq ELT LIST)Fdelete
  5044. Delete by side effect any occurrences of ELT as a member of LIST.
  5045. The modified LIST is returned.  Comparison is done with `equal'.
  5046. If the first member of LIST is ELT, deleting it is not a side effect;
  5047. it is simply using a different list.
  5048. Therefore, write `(setq foo (delete element foo))'
  5049. to be sure of changing the value of `foo'.
  5050.  
  5051. (delete ELT LIST)Fnreverse
  5052. Reverse LIST by modifying cdr pointers.
  5053. Returns the beginning of the reversed list.
  5054.  
  5055. (nreverse LIST)Freverse
  5056. Reverse LIST, copying.  Returns the beginning of the reversed list.
  5057. See also the function `nreverse', which is used more often.
  5058.  
  5059. (reverse LIST)Fsort
  5060. Sort LIST, stably, comparing elements using PREDICATE.
  5061. Returns the sorted list.  LIST is modified by side effects.
  5062. PREDICATE is called with two elements of LIST, and should return T
  5063. if the first element is "less" than the second.
  5064.  
  5065. (sort LIST PREDICATE)Fplist-get
  5066. Extract a value from a property list.
  5067. PLIST is a property list, which is a list of the form
  5068. (PROP1 VALUE1 PROP2 VALUE2...).  This function returns the value
  5069. corresponding to the given PROP, or nil if PROP is not
  5070. one of the properties on the list.
  5071.  
  5072. (plist-get PLIST PROP)Fget
  5073. Return the value of SYMBOL's PROPNAME property.
  5074. This is the last value stored with `(put SYMBOL PROPNAME VALUE)'.
  5075.  
  5076. (get SYMBOL PROPNAME)Fplist-put
  5077. Change value in PLIST of PROP to VAL.
  5078. PLIST is a property list, which is a list of the form
  5079. (PROP1 VALUE1 PROP2 VALUE2 ...).  PROP is a symbol and VAL is any object.
  5080. If PROP is already a property on the list, its value is set to VAL,
  5081. otherwise the new PROP VAL pair is added.  The new plist is returned;
  5082. use `(setq x (plist-put x prop val))' to be sure to use the new value.
  5083. The PLIST is modified by side effects.
  5084.  
  5085. (plist-put PLIST PROP VAL)Fput
  5086. Store SYMBOL's PROPNAME property with value VALUE.
  5087. It can be retrieved with `(get SYMBOL PROPNAME)'.
  5088.  
  5089. (put SYMBOL PROPNAME VALUE)Fequal
  5090. T if two Lisp objects have similar structure and contents.
  5091. They must have the same data type.
  5092. Conses are compared by comparing the cars and the cdrs.
  5093. Vectors and strings are compared element by element.
  5094. Numbers are compared by value, but integers cannot equal floats.
  5095.  (Use `=' if you want integers and floats to be able to be equal.)
  5096. Symbols must match exactly.
  5097.  
  5098. (equal O1 O2)Ffillarray
  5099. Store each element of ARRAY with ITEM.
  5100. ARRAY is a vector, string, char-table, or bool-vector.
  5101.  
  5102. (fillarray ARRAY ITEM)Fchar-table-subtype
  5103. Return the subtype of char-table CHAR-TABLE.   The value is a symbol.
  5104.  
  5105. (char-table-subtype CHAR-TABLE)Fchar-table-parent
  5106. Return the parent char-table of CHAR-TABLE.
  5107. The value is either nil or another char-table.
  5108. If CHAR-TABLE holds nil for a given character,
  5109. then the actual applicable value is inherited from the parent char-table
  5110. (or from its parents, if necessary).
  5111.  
  5112. (char-table-parent CHAR-TABLE)Fset-char-table-parent
  5113. Set the parent char-table of CHAR-TABLE to PARENT.
  5114. PARENT must be either nil or another char-table.
  5115.  
  5116. (set-char-table-parent CHAR-TABLE PARENT)Fchar-table-extra-slot
  5117. Return the value in extra-slot number N of char-table CHAR-TABLE.
  5118.  
  5119. (char-table-extra-slot CHAR-TABLE N)Fset-char-table-extra-slot
  5120. Set extra-slot number N of CHAR-TABLE to VALUE.
  5121.  
  5122. (set-char-table-extra-slot CHAR-TABLE N VALUE)Fchar-table-range
  5123. Return the value in CHAR-TABLE for a range of characters RANGE.
  5124. RANGE should be t (for all characters), nil (for the default value)
  5125. a vector which identifies a character set or a row of a character set,
  5126. or a character code.
  5127.  
  5128. (char-table-range CHAR-TABLE RANGE)Fset-char-table-range
  5129. Set the value in CHAR-TABLE for a range of characters RANGE to VALUE.
  5130. RANGE should be t (for all characters), nil (for the default value)
  5131. a vector which identifies a character set or a row of a character set,
  5132. or a character code.
  5133.  
  5134. (set-char-table-range CHAR-TABLE RANGE VALUE)Fmap-char-table
  5135. Call FUNCTION for each range of like characters in CHAR-TABLE.
  5136. FUNCTION is called with two arguments--a key and a value.
  5137. The key is always a possible RANGE argument to `set-char-table-range'.
  5138.  
  5139. (map-char-table FUNCTION CHAR-TABLE)Fnconc
  5140. Concatenate any number of lists by altering them.
  5141. Only the last argument is not altered, and need not be a list.Fmapconcat
  5142. Apply FUNCTION to each element of SEQUENCE, and concat the results as strings.
  5143. In between each pair of results, stick in SEPARATOR.  Thus, " " as
  5144. SEPARATOR results in spaces between the values returned by FUNCTION.
  5145.  
  5146. (mapconcat FUNCTION SEQUENCE SEPARATOR)Fmapcar
  5147. Apply FUNCTION to each element of SEQUENCE, and make a list of the results.
  5148. The result is a list just as long as SEQUENCE.
  5149. SEQUENCE may be a list, a vector or a string.
  5150.  
  5151. (mapcar FUNCTION SEQUENCE)Fy-or-n-p
  5152. Ask user a "y or n" question.  Return t if answer is "y".
  5153. Takes one argument, which is the string to display to ask the question.
  5154. It should end in a space; `y-or-n-p' adds `(y or n) ' to it.
  5155. No confirmation of the answer is requested; a single character is enough.
  5156. Also accepts Space to mean yes, or Delete to mean no.
  5157.  
  5158. (y-or-n-p PROMPT)Fyes-or-no-p
  5159. Ask user a yes-or-no question.  Return t if answer is yes.
  5160. Takes one argument, which is the string to display to ask the question.
  5161. It should end in a space; `yes-or-no-p' adds `(yes or no) ' to it.
  5162. The user must confirm the answer with RET,
  5163. and can edit it until it has been confirmed.
  5164.  
  5165. (yes-or-no-p PROMPT)Fload-average
  5166. Return list of 1 minute, 5 minute and 15 minute load averages.
  5167. Each of the three load averages is multiplied by 100,
  5168. then converted to integer.
  5169. If the 5-minute or 15-minute load averages are not available, return a
  5170. shortened list, containing only those averages which are available.
  5171.  
  5172. (load-average)Ffeaturep
  5173. Returns t if FEATURE is present in this Emacs.
  5174. Use this to conditionalize execution of lisp code based on the presence or
  5175. absence of emacs or environment extensions.
  5176. Use `provide' to declare that a feature is available.
  5177. This function looks at the value of the variable `features'.
  5178.  
  5179. (featurep FEATURE)Fprovide
  5180. Announce that FEATURE is a feature of the current Emacs.
  5181.  
  5182. (provide FEATURE)Frequire
  5183. If feature FEATURE is not loaded, load it from FILENAME.
  5184. If FEATURE is not a member of the list `features', then the feature
  5185. is not loaded; so load the file FILENAME.
  5186. If FILENAME is omitted, the printname of FEATURE is used as the file name.
  5187.  
  5188. (require FEATURE &optional FILE-NAME)Vfeatures
  5189. A list of symbols which are the features of the executing emacs.
  5190. Used by `featurep' and `require', and altered by `provide'.Fwrite-char
  5191. Output character CHARACTER to stream PRINTCHARFUN.
  5192. PRINTCHARFUN defaults to the value of `standard-output' (which see).
  5193.  
  5194. (write-char CHARACTER &optional PRINTCHARFUN)Fwith-output-to-temp-buffer
  5195. Bind `standard-output' to buffer BUFNAME, eval BODY, then show that buffer.
  5196. The buffer is cleared out initially, and marked as unmodified when done.
  5197. All output done by BODY is inserted in that buffer by default.
  5198. The buffer is displayed in another window, but not selected.
  5199. The value of the last form in BODY is returned.
  5200. If BODY does not finish normally, the buffer BUFNAME is not displayed.
  5201.  
  5202. If variable `temp-buffer-show-function' is non-nil, call it at the end
  5203. to get the buffer displayed.  It gets one argument, the buffer to display.Fterpri
  5204. Output a newline to stream PRINTCHARFUN.
  5205. If PRINTCHARFUN is omitted or nil, the value of `standard-output' is used.
  5206.  
  5207. (terpri &optional PRINTCHARFUN)Fprin1
  5208. Output the printed representation of OBJECT, any Lisp object.
  5209. Quoting characters are printed when needed to make output that `read'
  5210. can handle, whenever this is possible.
  5211. Output stream is PRINTCHARFUN, or value of `standard-output' (which see).
  5212.  
  5213. (prin1 OBJECT &optional PRINTCHARFUN)Fprin1-to-string
  5214. Return a string containing the printed representation of OBJECT,
  5215. any Lisp object.  Quoting characters are used when needed to make output
  5216. that `read' can handle, whenever this is possible, unless the optional
  5217. second argument NOESCAPE is non-nil.
  5218.  
  5219. (prin1-to-string OBJECT &optional NOESCAPE)Fprinc
  5220. Output the printed representation of OBJECT, any Lisp object.
  5221. No quoting characters are used; no delimiters are printed around
  5222. the contents of strings.
  5223. Output stream is PRINTCHARFUN, or value of standard-output (which see).
  5224.  
  5225. (princ OBJECT &optional PRINTCHARFUN)Fprint
  5226. Output the printed representation of OBJECT, with newlines around it.
  5227. Quoting characters are printed when needed to make output that `read'
  5228. can handle, whenever this is possible.
  5229. Output stream is PRINTCHARFUN, or value of `standard-output' (which see).
  5230.  
  5231. (print OBJECT &optional PRINTCHARFUN)Fexternal-debugging-output
  5232. Write CHARACTER to stderr.
  5233. You can call print while debugging emacs, and pass it this function
  5234. to make it write to the debugging output.
  5235.  
  5236.  
  5237. (external-debugging-output CHARACTER)Ferror-message-string
  5238. Convert an error value (ERROR-SYMBOL . DATA) to an error message.
  5239.  
  5240. (error-message-string OBJ)Vstandard-output
  5241. Output stream `print' uses by default for outputting a character.
  5242. This may be any function of one argument.
  5243. It may also be a buffer (output is inserted before point)
  5244. or a marker (output is inserted and the marker is advanced)
  5245. or the symbol t (output appears in the echo area).Vfloat-output-format
  5246. The format descriptor string used to print floats.
  5247. This is a %-spec like those accepted by `printf' in C,
  5248. but with some restrictions.  It must start with the two characters `%.'.
  5249. After that comes an integer precision specification,
  5250. and then a letter which controls the format.
  5251. The letters allowed are `e', `f' and `g'.
  5252. Use `e' for exponential notation "DIG.DIGITSeEXPT"
  5253. Use `f' for decimal point notation "DIGITS.DIGITS".
  5254. Use `g' to choose the shorter of those two formats for the number at hand.
  5255. The precision in any of these cases is the number of digits following
  5256. the decimal point.  With `f', a precision of 0 means to omit the
  5257. decimal point.  0 is not allowed with `e' or `g'.
  5258.  
  5259. A value of nil means to use `%.17g'.Vprint-length
  5260. Maximum length of list to print before abbreviating.
  5261. A value of nil means no limit.Vprint-level
  5262. Maximum depth of list nesting to print before abbreviating.
  5263. A value of nil means no limit.Vprint-escape-newlines
  5264. Non-nil means print newlines in strings as backslash-n.
  5265. Also print formfeeds as backslash-f.Fread-char
  5266. Read a character from the command input (keyboard or macro).
  5267. It is returned as a number.
  5268. If the user generates an event which is not a character (i.e. a mouse
  5269. click or function key event), `read-char' signals an error.  As an
  5270. exception, switch-frame events are put off until non-ASCII events can
  5271. be read.
  5272. If you want to read non-character events, or ignore them, call
  5273. `read-event' or `read-char-exclusive' instead.
  5274.  
  5275. (read-char)Fread-event
  5276. Read an event object from the input stream.
  5277.  
  5278. (read-event)Fread-char-exclusive
  5279. Read a character from the command input (keyboard or macro).
  5280. It is returned as a number.  Non-character events are ignored.
  5281.  
  5282. (read-char-exclusive)Fget-file-char
  5283. Don't use this yourself.
  5284.  
  5285. (get-file-char)Fload
  5286. Execute a file of Lisp code named FILE.
  5287. First try FILE with `.elc' appended, then try with `.el',
  5288.  then try FILE unmodified.
  5289. This function searches the directories in `load-path'.
  5290. If optional second arg NOERROR is non-nil,
  5291.  report no error if FILE doesn't exist.
  5292. Print messages at start and end of loading unless
  5293.  optional third arg NOMESSAGE is non-nil.
  5294. If optional fourth arg NOSUFFIX is non-nil, don't try adding
  5295.  suffixes `.elc' or `.el' to the specified name FILE.
  5296. Return t if file exists.
  5297.  
  5298. (load FILE &optional NOERROR NOMESSAGE NOSUFFIX)Feval-buffer
  5299. Execute the current buffer as Lisp code.
  5300. Programs can pass two arguments, BUFFER and PRINTFLAG.
  5301. BUFFER is the buffer to evaluate (nil means use current buffer).
  5302. PRINTFLAG controls printing of output:
  5303. nil means discard it; anything else is stream for print.
  5304.  
  5305. If there is no error, point does not move.  If there is an error,
  5306. point remains at the end of the last character read from the buffer.
  5307.  
  5308. (eval-buffer &optional BUFFER PRINTFLAG)Feval-current-buffer
  5309. Execute the current buffer as Lisp code.
  5310. Programs can pass argument PRINTFLAG which controls printing of output:
  5311. nil means discard it; anything else is stream for print.
  5312.  
  5313. If there is no error, point does not move.  If there is an error,
  5314. point remains at the end of the last character read from the buffer.
  5315.  
  5316. (eval-current-buffer &optional PRINTFLAG)Feval-region
  5317. Execute the region as Lisp code.
  5318. When called from programs, expects two arguments,
  5319. giving starting and ending indices in the current buffer
  5320. of the text to be executed.
  5321. Programs can pass third argument PRINTFLAG which controls output:
  5322. nil means discard it; anything else is stream for printing it.
  5323.  
  5324. If there is no error, point does not move.  If there is an error,
  5325. point remains at the end of the last character read from the buffer.
  5326.  
  5327. (eval-region START END &optional PRINTFLAG)Fread
  5328. Read one Lisp expression as text from STREAM, return as Lisp object.
  5329. If STREAM is nil, use the value of `standard-input' (which see).
  5330. STREAM or the value of `standard-input' may be:
  5331.  a buffer (read from point and advance it)
  5332.  a marker (read from where it points and advance it)
  5333.  a function (call it with no arguments for each character,
  5334.      call it with a char as argument to push a char back)
  5335.  a string (takes text from string, starting at the beginning)
  5336.  t (read text line using minibuffer and use it).
  5337.  
  5338. (read &optional STREAM)Fread-from-string
  5339. Read one Lisp expression which is represented as text by STRING.
  5340. Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
  5341. START and END optionally delimit a substring of STRING from which to read;
  5342.  they default to 0 and (length STRING) respectively.
  5343.  
  5344. (read-from-string STRING &optional START END)Fintern
  5345. Return the canonical symbol whose name is STRING.
  5346. If there is none, one is created by this function and returned.
  5347. A second optional argument specifies the obarray to use;
  5348. it defaults to the value of `obarray'.
  5349.  
  5350. (intern STRING &optional OBARRAY)Fintern-soft
  5351. Return the canonical symbol whose name is STRING, or nil if none exists.
  5352. A second optional argument specifies the obarray to use;
  5353. it defaults to the value of `obarray'.
  5354.  
  5355. (intern-soft STRING &optional OBARRAY)Funintern
  5356. Delete the symbol named NAME, if any, from OBARRAY.
  5357. The value is t if a symbol was found and deleted, nil otherwise.
  5358. NAME may be a string or a symbol.  If it is a symbol, that symbol
  5359. is deleted, if it belongs to OBARRAY--no other symbol is deleted.
  5360. OBARRAY defaults to the value of the variable `obarray'.
  5361.  
  5362. (unintern NAME &optional OBARRAY)Fmapatoms
  5363. Call FUNCTION on every symbol in OBARRAY.
  5364. OBARRAY defaults to the value of `obarray'.
  5365.  
  5366. (mapatoms FUNCTION &optional OBARRAY)Vobarray
  5367. Symbol table for use by `intern' and `read'.
  5368. It is a vector whose length ought to be prime for best results.
  5369. The vector's contents don't make sense if examined from Lisp programs;
  5370. to find all the symbols in an obarray, use `mapatoms'.Vvalues
  5371. List of values of all expressions which were read, evaluated and printed.
  5372. Order is reverse chronological.Vstandard-input
  5373. Stream for read to get input from.
  5374. See documentation of `read' for possible values.Vload-path
  5375. *List of directories to search for files to load.
  5376. Each element is a string (directory name) or nil (try default directory).
  5377. Initialized based on EMACSLOADPATH environment variable, if any,
  5378. otherwise to default specified by file `paths.h' when Emacs was built.Vload-in-progress
  5379. Non-nil iff inside of `load'.Vafter-load-alist
  5380. An alist of expressions to be evalled when particular files are loaded.
  5381. Each element looks like (FILENAME FORMS...).
  5382. When `load' is run and the file-name argument is FILENAME,
  5383. the FORMS in the corresponding element are executed at the end of loading.
  5384.  
  5385. FILENAME must match exactly!  Normally FILENAME is the name of a library,
  5386. with no directory specified, since that is how `load' is normally called.
  5387. An error in FORMS does not undo the load,
  5388. but does prevent execution of the rest of the FORMS.Vload-history
  5389. Alist mapping source file names to symbols and features.
  5390. Each alist element is a list that starts with a file name,
  5391. except for one element (optional) that starts with nil and describes
  5392. definitions evaluated from buffers not visiting files.
  5393. The remaining elements of each list are symbols defined as functions
  5394. or variables, and cons cells `(provide . FEATURE)' and `(require . FEATURE)'.Vload-file-name
  5395. Full name of file being loaded by `load'.Vcurrent-load-list
  5396. Used for internal purposes by `load'.Vemx-cdrom-load
  5397. *Non-nil if `load' should try again if the file is not found,
  5398. replacing `-' with `_' in the file name.Vload-read-function
  5399. Function used by `load' and `eval-region' for reading expressions.
  5400. The default is nil, which means use the function `read'.Vload-force-doc-strings
  5401. Non-nil means `load' should force-load all dynamic doc strings.
  5402. This is useful when the file being loaded is a temporary copy.Vsource-directory
  5403. Directory in which Emacs sources were found when Emacs was built.
  5404. You cannot count on them to still be there!Fmake-abbrev-table
  5405. Create a new, empty abbrev table object.
  5406.  
  5407. (make-abbrev-table)Fclear-abbrev-table
  5408. Undefine all abbrevs in abbrev table TABLE, leaving it empty.
  5409.  
  5410. (clear-abbrev-table TABLE)Fdefine-abbrev
  5411. Define an abbrev in TABLE named NAME, to expand to EXPANSION and call HOOK.
  5412. NAME and EXPANSION are strings.
  5413. To undefine an abbrev, define it with EXPANSION = nil.
  5414. If HOOK is non-nil, it should be a function of no arguments;
  5415. it is called after EXPANSION is inserted.
  5416.  
  5417. (define-abbrev TABLE NAME EXPANSION &optional HOOK COUNT)Fdefine-global-abbrev
  5418. Define ABBREV as a global abbreviation for EXPANSION.
  5419.  
  5420. (define-global-abbrev ABBREV EXPANSION)Fdefine-mode-abbrev
  5421. Define ABBREV as a mode-specific abbreviation for EXPANSION.
  5422.  
  5423. (define-mode-abbrev ABBREV EXPANSION)Fabbrev-symbol
  5424. Return the symbol representing abbrev named ABBREV.
  5425. This symbol's name is ABBREV, but it is not the canonical symbol of that name;
  5426. it is interned in an abbrev-table rather than the normal obarray.
  5427. The value is nil if that abbrev is not defined.
  5428. Optional second arg TABLE is abbrev table to look it up in.
  5429. The default is to try buffer's mode-specific abbrev table, then global table.
  5430.  
  5431. (abbrev-symbol ABBREV &optional TABLE)Fabbrev-expansion
  5432. Return the string that ABBREV expands into in the current buffer.
  5433. Optionally specify an abbrev table as second arg;
  5434. then ABBREV is looked up in that table only.
  5435.  
  5436. (abbrev-expansion ABBREV &optional TABLE)Fexpand-abbrev
  5437. Expand the abbrev before point, if there is an abbrev there.
  5438. Effective when explicitly called even when `abbrev-mode' is nil.
  5439. Returns t if expansion took place.
  5440.  
  5441. (expand-abbrev)Funexpand-abbrev
  5442. Undo the expansion of the last abbrev that expanded.
  5443. This differs from ordinary undo in that other editing done since then
  5444. is not undone.
  5445.  
  5446. (unexpand-abbrev)Finsert-abbrev-table-description
  5447. Insert before point a full description of abbrev table named NAME.
  5448. NAME is a symbol whose value is an abbrev table.
  5449. If optional 2nd arg READABLE is non-nil, a human-readable description
  5450. is inserted.  Otherwise the description is an expression,
  5451. a call to `define-abbrev-table', which would
  5452. define the abbrev table NAME exactly as it is currently defined.
  5453.  
  5454. (insert-abbrev-table-description NAME &optional READABLE)Fdefine-abbrev-table
  5455. Define TABLENAME (a symbol) as an abbrev table name.
  5456. Define abbrevs in it according to DEFINITIONS, which is a list of elements
  5457. of the form (ABBREVNAME EXPANSION HOOK USECOUNT).
  5458.  
  5459. (define-abbrev-table TABLENAME DEFINITIONS)Vabbrev-table-name-list
  5460. List of symbols whose values are abbrev tables.Vglobal-abbrev-table
  5461. The abbrev table whose abbrevs affect all buffers.
  5462. Each buffer may also have a local abbrev table.
  5463. If it does, the local table overrides the global one
  5464. for any particular abbrev defined in both.Vfundamental-mode-abbrev-table
  5465. The abbrev table of mode-specific abbrevs for Fundamental Mode.Vlast-abbrev
  5466. The abbrev-symbol of the last abbrev expanded.  See `abbrev-symbol'.Vlast-abbrev-text
  5467. The exact text of the last abbrev expanded.
  5468. nil if the abbrev has already been unexpanded.Vlast-abbrev-location
  5469. The location of the start of the last abbrev expanded.Vabbrev-start-location
  5470. Buffer position for `expand-abbrev' to use as the start of the abbrev.
  5471. nil means use the word before point as the abbrev.
  5472. Calling `expand-abbrev' sets this to nil.Vabbrev-start-location-buffer
  5473. Buffer that `abbrev-start-location' has been set for.
  5474. Trying to expand an abbrev in any other buffer clears `abbrev-start-location'.Vlocal-abbrev-table
  5475. Local (mode-specific) abbrev table of current buffer.Vabbrevs-changed
  5476. Set non-nil by defining or altering any word abbrevs.
  5477. This causes `save-some-buffers' to offer to save the abbrevs.Vabbrev-all-caps
  5478. *Set non-nil means expand multi-word abbrevs all caps if abbrev was so.Vpre-abbrev-expand-hook
  5479. Function or functions to be called before abbrev expansion is done.
  5480. This is the first thing that `expand-abbrev' does, and so this may change
  5481. the current abbrev table before abbrev lookup happens.Fsyntax-table-p
  5482. Return t if OBJECT is a syntax table.
  5483. Currently, any char-table counts as a syntax table.
  5484.  
  5485. (syntax-table-p OBJECT)Fsyntax-table
  5486. Return the current syntax table.
  5487. This is the one specified by the current buffer.
  5488.  
  5489. (syntax-table)Fstandard-syntax-table
  5490. Return the standard syntax table.
  5491. This is the one used for new buffers.
  5492.  
  5493. (standard-syntax-table)Fcopy-syntax-table
  5494. Construct a new syntax table and return it.
  5495. It is a copy of the TABLE, which defaults to the standard syntax table.
  5496.  
  5497. (copy-syntax-table &optional TABLE)Fset-syntax-table
  5498. Select a new syntax table for the current buffer.
  5499. One argument, a syntax table.
  5500.  
  5501. (set-syntax-table TABLE)Fchar-syntax
  5502. Return the syntax code of CHARACTER, described by a character.
  5503. For example, if CHARACTER is a word constituent,
  5504. the character `w' is returned.
  5505. The characters that correspond to various syntax codes
  5506. are listed in the documentation of `modify-syntax-entry'.
  5507.  
  5508. (char-syntax CHARACTER)Fmatching-paren
  5509. Return the matching parenthesis of CHARACTER, or nil if none.
  5510.  
  5511. (matching-paren CHARACTER)Fmodify-syntax-entry
  5512. Set syntax for character CHAR according to string S.
  5513. The syntax is changed only for table TABLE, which defaults to
  5514.  the current buffer's syntax table.
  5515. The first character of S should be one of the following:
  5516.   Space or -  whitespace syntax.    w   word constituent.
  5517.   _           symbol constituent.   .   punctuation.
  5518.   (           open-parenthesis.     )   close-parenthesis.
  5519.   "           string quote.         \   escape.
  5520.   $           paired delimiter.     '   expression quote or prefix operator.
  5521.   <           comment starter.      >   comment ender.
  5522.   /           character-quote.      @   inherit from `standard-syntax-table'.
  5523.  
  5524. Only single-character comment start and end sequences are represented thus.
  5525. Two-character sequences are represented as described below.
  5526. The second character of S is the matching parenthesis,
  5527.  used only if the first character is `(' or `)'.
  5528. Any additional characters are flags.
  5529. Defined flags are the characters 1, 2, 3, 4, b, and p.
  5530.  1 means CHAR is the start of a two-char comment start sequence.
  5531.  2 means CHAR is the second character of such a sequence.
  5532.  3 means CHAR is the start of a two-char comment end sequence.
  5533.  4 means CHAR is the second character of such a sequence.
  5534.  
  5535. There can be up to two orthogonal comment sequences. This is to support
  5536. language modes such as C++.  By default, all comment sequences are of style
  5537. a, but you can set the comment sequence style to b (on the second character
  5538. of a comment-start, or the first character of a comment-end sequence) using
  5539. this flag:
  5540.  b means CHAR is part of comment sequence b.
  5541.  
  5542.  p means CHAR is a prefix character for `backward-prefix-chars';
  5543.    such characters are treated as whitespace when they occur
  5544.    between expressions.
  5545.  
  5546. (modify-syntax-entry CHAR S &optional TABLE)Fdescribe-syntax
  5547. Describe the syntax specifications in the syntax table.
  5548. The descriptions are inserted in a buffer, which is then displayed.
  5549.  
  5550. (describe-syntax)Fforward-word
  5551. Move point forward ARG words (backward if ARG is negative).
  5552. Normally returns t.
  5553. If an edge of the buffer is reached, point is left there
  5554. and nil is returned.
  5555.  
  5556. (forward-word COUNT)Fforward-comment
  5557. Move forward across up to N comments.  If N is negative, move backward.
  5558. Stop scanning if we find something other than a comment or whitespace.
  5559. Set point to where scanning stops.
  5560. If N comments are found as expected, with nothing except whitespace
  5561. between them, return t; otherwise return nil.
  5562.  
  5563. (forward-comment COUNT)Fscan-lists
  5564. Scan from character number FROM by COUNT lists.
  5565. Returns the character number of the position thus found.
  5566.  
  5567. If DEPTH is nonzero, paren depth begins counting from that value,
  5568. only places where the depth in parentheses becomes zero
  5569. are candidates for stopping; COUNT such places are counted.
  5570. Thus, a positive value for DEPTH means go out levels.
  5571.  
  5572. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  5573.  
  5574. If the beginning or end of (the accessible part of) the buffer is reached
  5575. and the depth is wrong, an error is signaled.
  5576. If the depth is right but the count is not used up, nil is returned.
  5577.  
  5578. (scan-lists FROM COUNT DEPTH)Fscan-sexps
  5579. Scan from character number FROM by COUNT balanced expressions.
  5580. If COUNT is negative, scan backwards.
  5581. Returns the character number of the position thus found.
  5582.  
  5583. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  5584.  
  5585. If the beginning or end of (the accessible part of) the buffer is reached
  5586. in the middle of a parenthetical grouping, an error is signaled.
  5587. If the beginning or end is reached between groupings
  5588. but before count is used up, nil is returned.
  5589.  
  5590. (scan-sexps FROM COUNT)Fbackward-prefix-chars
  5591. Move point backward over any number of chars with prefix syntax.
  5592. This includes chars with "quote" or "prefix" syntax (' or p).
  5593.  
  5594. (backward-prefix-chars)Fparse-partial-sexp
  5595. Parse Lisp syntax starting at FROM until TO; return status of parse at TO.
  5596. Parsing stops at TO or when certain criteria are met;
  5597.  point is set to where parsing stops.
  5598. If fifth arg STATE is omitted or nil,
  5599.  parsing assumes that FROM is the beginning of a function.
  5600. Value is a list of eight elements describing final state of parsing:
  5601.  0. depth in parens.
  5602.  1. character address of start of innermost containing list; nil if none.
  5603.  2. character address of start of last complete sexp terminated.
  5604.  3. non-nil if inside a string.
  5605.     (it is the character that will terminate the string.)
  5606.  4. t if inside a comment.
  5607.  5. t if following a quote character.
  5608.  6. the minimum paren-depth encountered during this scan.
  5609.  7. t if in a comment of style `b'.
  5610. If third arg TARGETDEPTH is non-nil, parsing stops if the depth
  5611. in parentheses becomes equal to TARGETDEPTH.
  5612. Fourth arg STOPBEFORE non-nil means stop when come to
  5613.  any character that starts a sexp.
  5614. Fifth arg STATE is an eight-list like what this function returns.
  5615. It is used to initialize the state of the parse.  Its second and third
  5616. elements are ignored.
  5617. Sixth args COMMENTSTOP non-nil means stop at the start of a comment.
  5618.  
  5619. (parse-partial-sexp FROM TO &optional TARGETDEPTH STOPBEFORE STATE COMMENTSTOP)Vparse-sexp-ignore-comments
  5620. Non-nil means `forward-sexp', etc., should treat comments as whitespace.Vwords-include-escapes
  5621. Non-nil means `forward-word', etc., should treat escape chars part of words.Fml-if
  5622. Mocklisp version of `if'.Fml-nargs
  5623. Number of arguments to currently executing mocklisp function.
  5624.  
  5625. (ml-nargs)Fml-arg
  5626. Argument number N to currently executing mocklisp function.
  5627.  
  5628. (ml-arg N &optional PROMPT)Fml-interactive
  5629. True if currently executing mocklisp function was called interactively.
  5630.  
  5631. (ml-interactive)Fml-provide-prefix-argument
  5632. Evaluate second argument, using first argument as prefix arg value.Fml-prefix-argument-loop
  5633. Fml-substr
  5634. Return a substring of STRING, starting at index FROM and of length LENGTH.
  5635. If either FROM or LENGTH is negative, the length of STRING is added to it.
  5636.  
  5637. (ml-substr STRING FROM TO)Finsert-string
  5638. Mocklisp-compatibility insert function.
  5639. Like the function `insert' except that any argument that is a number
  5640. is converted into a string by expressing it in decimal.Fbyte-code
  5641. Function used internally in byte-compiled code.
  5642. The first argument, BYTESTR, is a string of byte code;
  5643. the second, VECTOR, a vector of constants;
  5644. the third, MAXDEPTH, the maximum stack depth used in this function.
  5645. If the third argument is incorrect, Emacs may crash.
  5646.  
  5647. (byte-code BYTESTR VECTOR MAXDEPTH)Vbyte-code-meter
  5648. A vector of vectors which holds a histogram of byte-code usage.
  5649. (aref (aref byte-code-meter 0) CODE) indicates how many times the byte
  5650. opcode CODE has been executed.
  5651. (aref (aref byte-code-meter CODE1) CODE2), where CODE1 is not 0,
  5652. indicates how many times the byte opcodes CODE1 and CODE2 have been
  5653. executed in succession.Vbyte-metering-on
  5654. If non-nil, keep profiling information on byte code usage.
  5655. The variable byte-code-meter indicates how often each byte opcode is used.
  5656. If a symbol has a property named `byte-code-meter' whose value is an
  5657. integer, it is incremented each time that symbol's function is called.Fprocessp
  5658. Return t if OBJECT is a process.
  5659.  
  5660. (processp OBJECT)Fget-process
  5661. Return the process named NAME, or nil if there is none.
  5662.  
  5663. (get-process NAME)Fget-buffer-process
  5664. Return the (or, a) process associated with BUFFER.
  5665. BUFFER may be a buffer or the name of one.
  5666.  
  5667. (get-buffer-process BUFFER)Fdelete-process
  5668. Delete PROCESS: kill it and forget about it immediately.
  5669. PROCESS may be a process, a buffer, the name of a process or buffer, or
  5670. nil, indicating the current buffer's process.
  5671.  
  5672. (delete-process PROCESS)Fprocess-status
  5673. Return the status of PROCESS: a symbol, one of these:
  5674. run  -- for a process that is running.
  5675. stop -- for a process stopped but continuable.
  5676. exit -- for a process that has exited.
  5677. signal -- for a process that has got a fatal signal.
  5678. open -- for a network stream connection that is open.
  5679. closed -- for a network stream connection that is closed.
  5680. nil -- if arg is a process name and no such process exists.
  5681. PROCESS may be a process, a buffer, the name of a process or buffer, or
  5682. nil, indicating the current buffer's process.
  5683.  
  5684. (process-status PROCESS)Fprocess-exit-status
  5685. Return the exit status of PROCESS or the signal number that killed it.
  5686. If PROCESS has not yet exited or died, return 0.
  5687.  
  5688. (process-exit-status PROCESS)Fprocess-id
  5689. Return the process id of PROCESS.
  5690. This is the pid of the Unix process which PROCESS uses or talks to.
  5691. For a network connection, this value is nil.
  5692.  
  5693. (process-id PROCESS)Fprocess-name
  5694. Return the name of PROCESS, as a string.
  5695. This is the name of the program invoked in PROCESS,
  5696. possibly modified to make it unique among process names.
  5697.  
  5698. (process-name PROCESS)Fprocess-command
  5699. Return the command that was executed to start PROCESS.
  5700. This is a list of strings, the first string being the program executed
  5701. and the rest of the strings being the arguments given to it.
  5702. For a non-child channel, this is nil.
  5703.  
  5704. (process-command PROCESS)Fprocess-tty-name
  5705. Return the name of the terminal PROCESS uses, or nil if none.
  5706. This is the terminal that the process itself reads and writes on,
  5707. not the name of the pty that Emacs uses to talk with that terminal.
  5708.  
  5709. (process-tty-name PROCESS)Fset-process-buffer
  5710. Set buffer associated with PROCESS to BUFFER (a buffer, or nil).
  5711.  
  5712. (set-process-buffer PROCESS BUFFER)Fprocess-buffer
  5713. Return the buffer PROCESS is associated with.
  5714. Output from PROCESS is inserted in this buffer
  5715. unless PROCESS has a filter.
  5716.  
  5717. (process-buffer PROCESS)Fprocess-mark
  5718. Return the marker for the end of the last output from PROCESS.
  5719.  
  5720. (process-mark PROCESS)Fset-process-filter
  5721. Give PROCESS the filter function FILTER; nil means no filter.
  5722. t means stop accepting output from the process.
  5723. When a process has a filter, each time it does output
  5724. the entire string of output is passed to the filter.
  5725. The filter gets two arguments: the process and the string of output.
  5726. If the process has a filter, its buffer is not used for output.
  5727.  
  5728. (set-process-filter PROCESS FILTER)Fprocess-filter
  5729. Returns the filter function of PROCESS; nil if none.
  5730. See `set-process-filter' for more info on filter functions.
  5731.  
  5732. (process-filter PROCESS)Fset-process-sentinel
  5733. Give PROCESS the sentinel SENTINEL; nil for none.
  5734. The sentinel is called as a function when the process changes state.
  5735. It gets two arguments: the process, and a string describing the change.
  5736.  
  5737. (set-process-sentinel PROCESS SENTINEL)Fprocess-sentinel
  5738. Return the sentinel of PROCESS; nil if none.
  5739. See `set-process-sentinel' for more info on sentinels.
  5740.  
  5741. (process-sentinel PROCESS)Fset-process-window-size
  5742. Tell PROCESS that it has logical window size HEIGHT and WIDTH.
  5743.  
  5744. (set-process-window-size PROCESS HEIGHT WIDTH)Fprocess-kill-without-query
  5745. Say no query needed if PROCESS is running when Emacs is exited.
  5746. Optional second argument if non-nil says to require a query.
  5747. Value is t if a query was formerly required.
  5748.  
  5749. (process-kill-without-query PROCESS &optional VALUE)Fprocess-connection
  5750. Return the connection type of `PROCESS'.
  5751. The value is `nil' for a pipe,
  5752. `t' or `pty' for a pty, or `stream' for a socket connection.
  5753.  
  5754. (process-connection PROCESS)Flist-processes
  5755. Display a list of all processes.
  5756. (Any processes listed as Exited or Signaled are actually eliminated
  5757. after the listing is made.)
  5758.  
  5759. (list-processes)Fprocess-list
  5760. Return a list of all processes.
  5761.  
  5762. (process-list)Fstart-process
  5763. Start a program in a subprocess.  Return the process object for it.
  5764. Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS
  5765. NAME is name for process.  It is modified if necessary to make it unique.
  5766. BUFFER is the buffer or (buffer-name) to associate with the process.
  5767.  Process output goes at end of that buffer, unless you specify
  5768.  an output stream or filter function to handle the output.
  5769.  BUFFER may be also nil, meaning that this process is not associated
  5770.  with any buffer
  5771. Third arg is program file name.  It is searched for as in the shell.
  5772. Remaining arguments are strings to give program as arguments.Fopen-network-stream
  5773. Open a TCP connection for a service to a host.
  5774. Returns a subprocess-object to represent the connection.
  5775. Input and output work as for subprocesses; `delete-process' closes it.
  5776. Args are NAME BUFFER HOST SERVICE.
  5777. NAME is name for process.  It is modified if necessary to make it unique.
  5778. BUFFER is the buffer (or buffer-name) to associate with the process.
  5779.  Process output goes at end of that buffer, unless you specify
  5780.  an output stream or filter function to handle the output.
  5781.  BUFFER may be also nil, meaning that this process is not associated
  5782.  with any buffer
  5783. Third arg is name of the host to connect to, or its IP address.
  5784. Fourth arg SERVICE is name of the service desired, or an integer
  5785.  specifying a port number to connect to.
  5786.  
  5787. (open-network-stream NAME BUFFER HOST SERVICE)Faccept-process-output
  5788. Allow any pending output from subprocesses to be read by Emacs.
  5789. It is read into the process' buffers or given to their filter functions.
  5790. Non-nil arg PROCESS means do not return until some output has been received
  5791. from PROCESS.
  5792. Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of
  5793. seconds and microseconds to wait; return after that much time whether
  5794. or not there is input.
  5795. Return non-nil iff we received any output before the timeout expired.
  5796.  
  5797. (accept-process-output &optional PROCESS TIMEOUT TIMEOUT-MSECS)Fwaiting-for-user-input-p
  5798. Returns non-nil if emacs is waiting for input from the user.
  5799. This is intended for use by asynchronous process output filters and sentinels.
  5800.  
  5801. (waiting-for-user-input-p)Fprocess-send-region
  5802. Send current contents of region as input to PROCESS.
  5803. PROCESS may be a process, a buffer, the name of a process or buffer, or
  5804. nil, indicating the current buffer's process.
  5805. Called from program, takes three arguments, PROCESS, START and END.
  5806. If the region is more than 500 characters long,
  5807. it is sent in several bunches.  This may happen even for shorter regions.
  5808. Output from processes can arrive in between bunches.
  5809.  
  5810. (process-send-region PROCESS START END)Fprocess-send-string
  5811. Send PROCESS the contents of STRING as input.
  5812. PROCESS may be a process, a buffer, the name of a process or buffer, or
  5813. nil, indicating the current buffer's process.
  5814. If STRING is more than 500 characters long,
  5815. it is sent in several bunches.  This may happen even for shorter strings.
  5816. Output from processes can arrive in between bunches.
  5817.  
  5818. (process-send-string PROCESS STRING)Finterrupt-process
  5819. Interrupt process PROCESS.  May be process or name of one.
  5820. PROCESS may be a process, a buffer, or the name of a process or buffer.
  5821. nil or no arg means current buffer's process.
  5822. Second arg CURRENT-GROUP non-nil means send signal to
  5823. the current process-group of the process's controlling terminal
  5824. rather than to the process's own process group.
  5825. If the process is a shell, this means interrupt current subjob
  5826. rather than the shell.
  5827.  
  5828. (interrupt-process &optional PROCESS CURRENT-GROUP)Fkill-process
  5829. Kill process PROCESS.  May be process or name of one.
  5830. See function `interrupt-process' for more details on usage.
  5831.  
  5832. (kill-process &optional PROCESS CURRENT-GROUP)Fquit-process
  5833. Send QUIT signal to process PROCESS.  May be process or name of one.
  5834. See function `interrupt-process' for more details on usage.
  5835.  
  5836. (quit-process &optional PROCESS CURRENT-GROUP)Fstop-process
  5837. Stop process PROCESS.  May be process or name of one.
  5838. See function `interrupt-process' for more details on usage.
  5839.  
  5840. (stop-process &optional PROCESS CURRENT-GROUP)Fcontinue-process
  5841. Continue process PROCESS.  May be process or name of one.
  5842. See function `interrupt-process' for more details on usage.
  5843.  
  5844. (continue-process &optional PROCESS CURRENT-GROUP)Fsignal-process
  5845. Send the process with process id PID the signal with code SIGCODE.
  5846. PID must be an integer.  The process need not be a child of this Emacs.
  5847. SIGCODE may be an integer, or a symbol whose name is a signal name.
  5848.  
  5849. (signal-process PID SIGCODE)Fprocess-send-eof
  5850. Make PROCESS see end-of-file in its input.
  5851. Eof comes after any text already sent to it.
  5852. PROCESS may be a process, a buffer, the name of a process or buffer, or
  5853. nil, indicating the current buffer's process.
  5854. If PROCESS is a network connection, or is a process communicating
  5855. through a pipe (as opposed to a pty), then you cannot send any more
  5856. text to PROCESS after you call this function.
  5857.  
  5858. (process-send-eof &optional PROCESS)Vdelete-exited-processes
  5859. *Non-nil means delete processes immediately when they exit.
  5860. nil means don't delete them until `list-processes' is run.Vprocess-connection-type
  5861. Control type of device used to communicate with subprocesses.
  5862. Values are nil to use a pipe, or t or `pty' to use a pty.
  5863. The value has no effect if the system has no ptys or if all ptys are busy:
  5864. then a pipe is used in any case.
  5865. The value takes effect when `start-process' is called.Fcall-process
  5866. Call PROGRAM synchronously in separate process.
  5867. The program's input comes from file INFILE (nil means `/dev/null').
  5868. Insert output in BUFFER before point; t means current buffer;
  5869.  nil for BUFFER means discard it; 0 means discard and don't wait.
  5870. BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
  5871. REAL-BUFFER says what to do with standard output, as above,
  5872. while STDERR-FILE says what to do with standard error in the child.
  5873. STDERR-FILE may be nil (discard standard error output),
  5874. t (mix it with ordinary output), or a file name string.
  5875.  
  5876. Fourth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  5877. Remaining arguments are strings passed as command arguments to PROGRAM.
  5878.  
  5879. If BUFFER is 0, `call-process' returns immediately with value nil.
  5880. Otherwise it waits for PROGRAM to terminate
  5881. and returns a numeric exit status or a signal description string.
  5882. If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.Fcall-process-region
  5883. Send text from START to END to a synchronous process running PROGRAM.
  5884. Delete the text if fourth arg DELETE is non-nil.
  5885.  
  5886. Insert output in BUFFER before point; t means current buffer;
  5887.  nil for BUFFER means discard it; 0 means discard and don't wait.
  5888. BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
  5889. REAL-BUFFER says what to do with standard output, as above,
  5890. while STDERR-FILE says what to do with standard error in the child.
  5891. STDERR-FILE may be nil (discard standard error output),
  5892. t (mix it with ordinary output), or a file name string.
  5893.  
  5894. Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  5895. Remaining args are passed to PROGRAM at startup as command args.
  5896.  
  5897. If BUFFER is nil, `call-process-region' returns immediately with value nil.
  5898. Otherwise it waits for PROGRAM to terminate
  5899. and returns a numeric exit status or a signal description string.
  5900. If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.Fgetenv
  5901. Return the value of environment variable VAR, as a string.
  5902. VAR should be a string.  Value is nil if VAR is undefined in the environment.
  5903. This function consults the variable ``process-environment'' for its value.
  5904.  
  5905. (getenv VAR)Vbinary-process-input
  5906. *If non-nil then new subprocesses are assumed to take binary input.Vbinary-process-output
  5907. *If non-nil then new subprocesses are assumed to produce binary output.Vshell-file-name
  5908. *File name to load inferior shells from.
  5909. Initialized from the SHELL environment variable.Vexec-path
  5910. *List of directories to search programs to run in subprocesses.
  5911. Each element is a string (directory name) or nil (try default directory).Vexec-directory
  5912. Directory of architecture-dependent files that come with GNU Emacs,
  5913. especially executable programs intended for Emacs to invoke.Vdata-directory
  5914. Directory of architecture-independent files that come with GNU Emacs,
  5915. intended for Emacs to use.Vdoc-directory
  5916. Directory containing the DOC file that comes with GNU Emacs.
  5917. This is usually the same as data-directory.Vconfigure-info-directory
  5918. For internal use by the build procedure only.
  5919. This is the name of the directory in which the build procedure installed
  5920. Emacs's info files; the default value for Info-default-directory-list
  5921. includes this.Vprocess-environment
  5922. List of environment variables for subprocesses to inherit.
  5923. Each element should be a string of the form ENVVARNAME=VALUE.
  5924. The environment which Emacs inherits is placed in this variable
  5925. when Emacs starts.Ffacep
  5926. Return t if X is a face name or an internal face vector.Fface-name
  5927. Return the name of face FACE.Fface-id
  5928. Return the internal ID number of face FACE.Fface-font
  5929. Return the font name of face FACE, or nil if it is unspecified.
  5930. If the optional argument FRAME is given, report on face FACE in that frame.
  5931. If FRAME is t, report on the defaults for face FACE (for new frames).
  5932.   The font default for a face is either nil, or a list
  5933.   of the form (bold), (italic) or (bold italic).
  5934. If FRAME is omitted or nil, use the selected frame.Fface-foreground
  5935. Return the foreground color name of face FACE, or nil if unspecified.
  5936. If the optional argument FRAME is given, report on face FACE in that frame.
  5937. If FRAME is t, report on the defaults for face FACE (for new frames).
  5938. If FRAME is omitted or nil, use the selected frame.Fface-background
  5939. Return the background color name of face FACE, or nil if unspecified.
  5940. If the optional argument FRAME is given, report on face FACE in that frame.
  5941. If FRAME is t, report on the defaults for face FACE (for new frames).
  5942. If FRAME is omitted or nil, use the selected frame.Fface-stipple
  5943. Return the stipple pixmap name of face FACE, or nil if unspecified.
  5944. If the optional argument FRAME is given, report on face FACE in that frame.
  5945. If FRAME is t, report on the defaults for face FACE (for new frames).
  5946. If FRAME is omitted or nil, use the selected frame.Fface-underline-p
  5947. Return t if face FACE is underlined.
  5948. If the optional argument FRAME is given, report on face FACE in that frame.
  5949. If FRAME is t, report on the defaults for face FACE (for new frames).
  5950. If FRAME is omitted or nil, use the selected frame.Fset-face-font
  5951. Change the font of face FACE to FONT (a string).
  5952. If the optional FRAME argument is provided, change only
  5953. in that frame; otherwise change each frame.Fset-face-foreground
  5954. Change the foreground color of face FACE to COLOR (a string).
  5955. If the optional FRAME argument is provided, change only
  5956. in that frame; otherwise change each frame.Vface-default-stipple
  5957. Default stipple pattern used on monochrome displays.
  5958. This stipple pattern is used on monochrome displays
  5959. instead of shades of gray for a face background color.
  5960. See `set-face-stipple' for possible values for this variable.Fface-color-gray-p
  5961. Return t if COLOR is a shade of gray (or white or black).
  5962. FRAME specifies the frame and thus the display for interpreting COLOR.Fset-face-background
  5963. Change the background color of face FACE to COLOR (a string).
  5964. If the optional FRAME argument is provided, change only
  5965. in that frame; otherwise change each frame.Fset-face-stipple
  5966. Change the stipple pixmap of face FACE to PIXMAP.
  5967. PIXMAP should be a string, the name of a file of pixmap data.
  5968. The directories listed in the `x-bitmap-file-path' variable are searched.
  5969.  
  5970. Alternatively, PIXMAP may be a list of the form (WIDTH HEIGHT DATA)
  5971. where WIDTH and HEIGHT are the size in pixels,
  5972. and DATA is a string, containing the raw bits of the bitmap.  
  5973.  
  5974. If the optional FRAME argument is provided, change only
  5975. in that frame; otherwise change each frame.Fset-face-underline-p
  5976. Specify whether face FACE is underlined.  (Yes if UNDERLINE-P is non-nil.)
  5977. If the optional FRAME argument is provided, change only
  5978. in that frame; otherwise change each frame.Fmodify-face
  5979. Change the display attributes for face FACE.
  5980. If the optional FRAME argument is provided, change only
  5981. in that frame; otherwise change each frame.
  5982.  
  5983. FOREGROUND and BACKGROUND should be a colour name string (or list of strings to
  5984. try) or nil.  STIPPLE should be a stipple pattern name string or nil.
  5985. If nil, means do not change the display attribute corresponding to that arg.
  5986.  
  5987. BOLD-P, ITALIC-P, and UNDERLINE-P specify whether the face should be set bold,
  5988. in italic, and underlined, respectively.  If neither nil or t, means do not
  5989. change the display attribute corresponding to that arg.
  5990.  
  5991. If called interactively, prompts for a face name and face attributes.Vglobal-face-data
  5992. Internal data for face support functions.  Not for external use.
  5993. This is an alist associating face names with the default values for
  5994. their parameters.  Newly created frames get their data from here.Fface-list
  5995. Returns a list of all defined face names.Finternal-find-face
  5996. Retrieve the face named NAME.  Return nil if there is no such face.
  5997. If the optional argument FRAME is given, this gets the face NAME for
  5998. that frame; otherwise, it uses the selected frame.
  5999. If FRAME is the symbol t, then the global, non-frame face is returned.
  6000. If NAME is already a face, it is simply returned.Finternal-get-face
  6001. Retrieve the face named NAME; error if there is none.
  6002. If the optional argument FRAME is given, this gets the face NAME for
  6003. that frame; otherwise, it uses the selected frame.
  6004. If FRAME is the symbol t, then the global, non-frame face is returned.
  6005. If NAME is already a face, it is simply returned.Fmake-face
  6006. Define a new FACE on all frames.  
  6007. You can modify the font, color, etc of this face with the set-face- functions.
  6008. If the face already exists, it is unmodified.Fcopy-face
  6009. Define a face just like OLD-FACE, with name NEW-FACE.
  6010. If NEW-FACE already exists as a face, it is modified to be like OLD-FACE.
  6011. If it doesn't already exist, it is created.
  6012.  
  6013. If the optional argument FRAME is given as a frame,
  6014. NEW-FACE is changed on FRAME only.
  6015. If FRAME is t, the frame-independent default specification for OLD-FACE
  6016. is copied to NEW-FACE.
  6017. If FRAME is nil, copying is done for the frame-independent defaults
  6018. and for each existing frame.
  6019. If the optional fourth argument NEW-FRAME is given, 
  6020. copy the information from face OLD-FACE on frame FRAME
  6021. to NEW-FACE on frame NEW-FRAME.Fface-equal
  6022. True if the faces FACE1 and FACE2 display in the same way.Fface-differs-from-default-p
  6023. True if face FACE displays differently from the default face, on FRAME.
  6024. A face is considered to be ``the same'' as the default face if it is 
  6025. actually specified in the same way (equivalent fonts, etc) or if it is 
  6026. fully unspecified, and thus inherits the attributes of any face it 
  6027. is displayed on top of.
  6028.  
  6029. The optional argument FRAME specifies which frame to test;
  6030. if FRAME is t, test the default for new frames.
  6031. If FRAME is nil or omitted, test the selected frame.Fface-nontrivial-p
  6032. True if face FACE has some non-nil attribute.
  6033. The optional argument FRAME specifies which frame to test;
  6034. if FRAME is t, test the default for new frames.
  6035. If FRAME is nil or omitted, test the selected frame.Finvert-face
  6036. Swap the foreground and background colors of face FACE.
  6037. If the face doesn't specify both foreground and background, then
  6038. set its foreground and background to the default background and foreground.Finternal-try-face-font
  6039. Like set-face-font, but returns nil on failure instead of an error.Fx-resolve-font-name
  6040. Return a font name matching PATTERN.
  6041. All wildcards in PATTERN become substantiated.
  6042. If PATTERN is nil, return the name of the frame's base font, which never
  6043. contains wildcards.
  6044. Given optional arguments FACE and FRAME, return a font which is
  6045. also the same size as FACE on FRAME, or fail.Fx-make-font-bold
  6046. Given an X font specification, make a bold version of it.
  6047. If that can't be done, return nil.Fx-make-font-demibold
  6048. Given an X font specification, make a demibold version of it.
  6049. If that can't be done, return nil.Fx-make-font-unbold
  6050. Given an X font specification, make a non-bold version of it.
  6051. If that can't be done, return nil.Fx-make-font-italic
  6052. Given an X font specification, make an italic version of it.
  6053. If that can't be done, return nil.Fx-make-font-oblique
  6054. Given an X font specification, make an oblique version of it.
  6055. If that can't be done, return nil.Fx-make-font-unitalic
  6056. Given an X font specification, make a non-italic version of it.
  6057. If that can't be done, return nil.Fmake-face-bold
  6058. Make the font of the given face be bold, if possible.  
  6059. If NOERROR is non-nil, return nil on failure.Fmake-face-italic
  6060. Make the font of the given face be italic, if possible.  
  6061. If NOERROR is non-nil, return nil on failure.Fmake-face-bold-italic
  6062. Make the font of the given face be bold and italic, if possible.  
  6063. If NOERROR is non-nil, return nil on failure.Fmake-face-unbold
  6064. Make the font of the given face be non-bold, if possible.  
  6065. If NOERROR is non-nil, return nil on failure.Fmake-face-unitalic
  6066. Make the font of the given face be non-italic, if possible.  
  6067. If NOERROR is non-nil, return nil on failure.Vlist-faces-sample-text
  6068. *Text string to display as the sample text for `list-faces-display'.Flist-faces-display
  6069. List all faces, using the same sample text in each.
  6070. The sample text is a string that comes from the variable
  6071. `list-faces-sample-text'.
  6072.  
  6073. It is possible to give a particular face name different appearances in
  6074. different frames.  This command shows the appearance in the
  6075. selected frame.Fdescribe-face
  6076. Display the properties of face FACE.Vfacemenu-key
  6077. Prefix key to use for facemenu commands.Vfacemenu-keybindings
  6078. Alist of interesting faces and keybindings. 
  6079. Each element is itself a list: the car is the name of the face,
  6080. the next element is the key to use as a keyboard equivalent of the menu item;
  6081. the binding is made in facemenu-keymap.
  6082.  
  6083. The faces specifically mentioned in this list are put at the top of
  6084. the menu, in the order specified.  All other faces which are defined,
  6085. except for those in `facemenu-unlisted-faces', are listed after them, 
  6086. but get no keyboard equivalents.
  6087.  
  6088. If you change this variable after loading facemenu.el, you will need to call
  6089. `facemenu-update' to make it take effect.Vfacemenu-new-faces-at-end
  6090. Where in the menu to insert newly-created faces.
  6091. This should be nil to put them at the top of the menu, or t to put them
  6092. just before "Other" at the end.Vfacemenu-unlisted-faces
  6093. List of faces not to include in the Face menu.
  6094. You can set this list before loading facemenu.el, or add a face to it before
  6095. creating that face if you do not want it to be listed.  If you change the
  6096. variable so as to eliminate faces that have already been added to the menu,
  6097. call `facemenu-update' to recalculate the menu contents.
  6098.  
  6099. If this variable is t, no faces will be added to the menu.  This is useful for
  6100. temporarily turning off the feature that automatically adds faces to the menu
  6101. when they are created.Vfacemenu-face-menu
  6102. Menu keymap for faces.Vfacemenu-foreground-menu
  6103. Menu keymap for foreground colors.Vfacemenu-background-menu
  6104. Menu keymap for background colorsVfacemenu-special-menu
  6105. Menu keymap for non-face text-properties.Vfacemenu-justification-menu
  6106. Submenu for text justification commands.Vfacemenu-indentation-menu
  6107. Submenu for indentation commands.Vfacemenu-menu
  6108. Facemenu top-level menu keymap.Vfacemenu-keymap
  6109. Keymap for face-changing commands.
  6110. `Facemenu-update' fills in the keymap according to the bindings
  6111. requested in `facemenu-keybindings'.Vfacemenu-add-face-function
  6112. Function called at beginning of text to change or `nil'.
  6113. This function is passed the FACE to set and END of text to change, and must
  6114. return a string which is inserted.  It may set `facemenu-end-add-face'.Vfacemenu-end-add-face
  6115. String to insert or function called at end of text to change or `nil'.
  6116. This function is passed the FACE to set, and must return a string which is
  6117. inserted.Vfacemenu-remove-face-function
  6118. When non-`nil' function called to remove faces.
  6119. This function is passed the START and END of text to change.
  6120. May also be `t' meaning to use `facemenu-add-face-function'.Vfacemenu-color-alist
  6121. Alist of colors, used for completion.
  6122. If null, `facemenu-read-color' will set it.Ffacemenu-update
  6123. Add or update the "Face" menu in the menu bar.
  6124. You can call this to update things if you change any of the menu configuration
  6125. variables.Ffacemenu-set-face
  6126. Add FACE to the region or next character typed.
  6127. It will be added to the top of the face list; any faces lower on the list that
  6128. will not show through at all will be removed.
  6129.  
  6130. Interactively, the face to be used is read with the minibuffer.
  6131.  
  6132. If the region is active and there is no prefix argument,
  6133. this command sets the region to the requested face.
  6134.  
  6135. Otherwise, this command specifies the face for the next character
  6136. inserted.  Moving point or switching buffers before
  6137. typing a character to insert cancels the specification.Ffacemenu-set-foreground
  6138. Set the foreground color of the region or next character typed.
  6139. The color is prompted for.  A face named `fg:color' is used (or created).
  6140. If the region is active, it will be set to the requested face.  If
  6141. it is inactive (even if mark-even-if-inactive is set) the next
  6142. character that is typed (via `self-insert-command') will be set to
  6143. the selected face.  Moving point or switching buffers before
  6144. typing a character cancels the request.Ffacemenu-set-background
  6145. Set the background color of the region or next character typed.
  6146. The color is prompted for.  A face named `bg:color' is used (or created).
  6147. If the region is active, it will be set to the requested face.  If
  6148. it is inactive (even if mark-even-if-inactive is set) the next
  6149. character that is typed (via `self-insert-command') will be set to
  6150. the selected face.  Moving point or switching buffers before
  6151. typing a character cancels the request.Ffacemenu-set-face-from-menu
  6152. Set the face of the region or next character typed.
  6153. This function is designed to be called from a menu; the face to use
  6154. is the menu item's name.
  6155.  
  6156. If the region is active and there is no prefix argument,
  6157. this command sets the region to the requested face.
  6158.  
  6159. Otherwise, this command specifies the face for the next character
  6160. inserted.  Moving point or switching buffers before
  6161. typing a character to insert cancels the specification.Ffacemenu-set-invisible
  6162. Make the region invisible.
  6163. This sets the `invisible' text property; it can be undone with
  6164. `facemenu-remove-special'.Ffacemenu-set-intangible
  6165. Make the region intangible: disallow moving into it.
  6166. This sets the `intangible' text property; it can be undone with
  6167. `facemenu-remove-special'.Ffacemenu-set-read-only
  6168. Make the region unmodifiable.
  6169. This sets the `read-only' text property; it can be undone with
  6170. `facemenu-remove-special'.Ffacemenu-remove-props
  6171. Remove all text properties that facemenu added to region.Ffacemenu-remove-all
  6172. Remove all text properties from the region.Ffacemenu-remove-special
  6173. Remove all the "special" text properties from the region.
  6174. These special properties include `invisible', `intangible' and `read-only'.Flist-text-properties-at
  6175. Pop up a buffer listing text-properties at LOCATION.Ffacemenu-read-color
  6176. Read a color using the minibuffer.Flist-colors-display
  6177. Display names of defined colors, and show what they look like.
  6178. If the optional argument LIST is non-nil, it should be a list of
  6179. colors to display.  Otherwise, this command computes a list
  6180. of colors that the current display can handle.Ffacemenu-color-equal
  6181. Return t if colors A and B are the same color.
  6182. A and B should be strings naming colors.
  6183. This function queries the window-system server to find out what the
  6184. color names mean.  It returns nil if the colors differ or if it can't
  6185. determine the correct answer.Ffacemenu-add-face
  6186. Add FACE to text between START and END.
  6187. If START is `nil' or START to END is empty, add FACE to next typed character
  6188. instead.  For each section of that region that has a different face property,
  6189. FACE will be consed onto it, and other faces that are completely hidden by
  6190. that will be removed from the list.
  6191. If `facemenu-add-face-function' and maybe `facemenu-end-add-face' are non-`nil'
  6192. they are used to set the face information.
  6193.  
  6194. As a special case, if FACE is `default', then the region is left with NO face
  6195. text property.  Otherwise, selecting the default face would not have any
  6196. effect.  See `facemenu-remove-face-function'.Ffacemenu-active-faces
  6197. Return from FACE-LIST those faces that would be used for display.
  6198. This means each face attribute is not specified in a face earlier in FACE-LIST
  6199. and such a face is therefore active when used to display text.
  6200. If the optional argument FRAME is given, use the faces in that frame; otherwise
  6201. use the selected frame.  If t, then the global, non-frame faces are used.Ffacemenu-get-face
  6202. Make sure FACE exists.
  6203. If not, it is created.  If it is created and is of the form `fg:color', then
  6204. set the foreground to that color. If of the form `bg:color', set the
  6205. background.  In any case, add it to the appropriate menu.  Returns the face,
  6206. or nil if given a bad color.Ffacemenu-add-new-face
  6207. Add a FACE to the appropriate Face menu.
  6208. Automatically called when a new face is created.Ffacemenu-complete-face-list
  6209. Return list of all faces that look different.
  6210. Starts with given ALIST of faces, and adds elements only if they display 
  6211. differently from any face already on the list.
  6212. The faces on ALIST will end up at the end of the returned list, in reverse 
  6213. order.Ffacemenu-iterate
  6214. Apply FUNC to each element of LIST until one returns non-nil.
  6215. Returns the non-nil value it found, or nil if all were nil.Vpi
  6216. The value of Pi (3.1415926...)Ve
  6217. The value of e (2.7182818...)Vdegrees-to-radians
  6218. Degrees to radian conversion constantVradians-to-degrees
  6219. Radian to degree conversion constantFdegrees-to-radians
  6220. Convert ARG from degrees to radians.Fradians-to-degrees
  6221. Convert ARG from radians to degrees.Vframe-creation-function
  6222. Window-system dependent function to call to create a new frame.
  6223. The window system startup file should set this to its frame creation
  6224. function, which should take an alist of parameters as its argument.Vinitial-frame-alist
  6225. Alist of frame parameters for creating the initial X window frame.
  6226. You can set this in your `.emacs' file; for example,
  6227.  (setq initial-frame-alist '((top . 1) (left . 1) (width . 80) (height . 55)))
  6228. Parameters specified here supersede the values given in `default-frame-alist'.
  6229.  
  6230. If the value calls for a frame without a minibuffer, and you have not created
  6231. a minibuffer frame on your own, one is created according to
  6232. `minibuffer-frame-alist'.
  6233.  
  6234. You can specify geometry-related options for just the initial frame
  6235. by setting this variable in your `.emacs' file; however, they won't
  6236. take effect until Emacs reads `.emacs', which happens after first creating
  6237. the frame.  If you want the frame to have the proper geometry as soon
  6238. as it appears, you need to use this three-step process:
  6239. * Specify X resources to give the geometry you want.
  6240. * Set `default-frame-alist' to override these options so that they
  6241.   don't affect subsequent frames.
  6242. * Set `initial-frame-alist' in a way that matches the X resources,
  6243.   to override what you put in `default-frame-alist'.Vminibuffer-frame-alist
  6244. Alist of frame parameters for initially creating a minibuffer frame.
  6245. You can set this in your `.emacs' file; for example,
  6246.  (setq minibuffer-frame-alist
  6247.    '((top . 1) (left . 1) (width . 80) (height . 2)))
  6248. Parameters specified here supersede the values given in
  6249. `default-frame-alist'.Vpop-up-frame-alist
  6250. Alist of frame parameters used when creating pop-up frames.
  6251. Pop-up frames are used for completions, help, and the like.
  6252. This variable can be set in your init file, like this:
  6253.   (setq pop-up-frame-alist '((width . 80) (height . 20)))
  6254. These supersede the values given in `default-frame-alist'.Vspecial-display-frame-alist
  6255. *Alist of frame parameters used when creating special frames.
  6256. Special frames are used for buffers whose names are in
  6257. `special-display-buffer-names' and for buffers whose names match
  6258. one of the regular expressions in `special-display-regexps'.
  6259. This variable can be set in your init file, like this:
  6260.   (setq special-display-frame-alist '((width . 80) (height . 20)))
  6261. These supersede the values given in `default-frame-alist'.Fnext-multiframe-window
  6262. Select the next window, regardless of which frame it is on.Fprevious-multiframe-window
  6263. Select the previous window, regardless of which frame it is on.Fmake-frame-on-display
  6264. Make a frame on display DISPLAY.
  6265. The optional second argument PARAMETERS specifies additional frame parameters.Fmake-frame-command
  6266. Make a new frame, and select it if the terminal displays only one frame.Fmake-frame
  6267. Create a new frame, displaying the current buffer.
  6268.  
  6269. Optional argument PARAMETERS is an alist of parameters for the new
  6270. frame.  Specifically, PARAMETERS is a list of pairs, each having
  6271. the form (NAME . VALUE).
  6272.  
  6273. Here are some of the parameters allowed (not a complete list):
  6274.  
  6275. (name . STRING)    - The frame should be named STRING.
  6276.  
  6277. (height . NUMBER) - The frame should be NUMBER text lines high.  If
  6278.     this parameter is present, the width parameter must also be
  6279.     given.
  6280.  
  6281. (width . NUMBER) - The frame should be NUMBER characters in width.
  6282.     If this parameter is present, the height parameter must also
  6283.     be given.
  6284.  
  6285. (minibuffer . t) - the frame should have a minibuffer
  6286. (minibuffer . nil) - the frame should have no minibuffer
  6287. (minibuffer . only) - the frame should contain only a minibuffer
  6288. (minibuffer . WINDOW) - the frame should use WINDOW as its minibuffer window.Ffiltered-frame-list
  6289. Return a list of all live frames which satisfy PREDICATE.Fminibuffer-frame-list
  6290. Return a list of all frames with their own minibuffers.Fframe-remove-geometry-params
  6291. Return the parameter list PARAM-LIST, but with geometry specs removed.
  6292. This deletes all bindings in PARAM-LIST for `top', `left', `width',
  6293. `height', `user-size' and `user-position' parameters.
  6294. Emacs uses this to avoid overriding explicit moves and resizings from
  6295. the user during startup.Fother-frame
  6296. Select the ARG'th different visible frame, and raise it.
  6297. All frames are arranged in a cyclic order.
  6298. This command selects the frame ARG steps away in that order.
  6299. A negative ARG moves in the opposite order.Fcurrent-frame-configuration
  6300. Return a list describing the positions and states of all frames.
  6301. Its car is `frame-configuration'.
  6302. Each element of the cdr is a list of the form (FRAME ALIST WINDOW-CONFIG),
  6303. where
  6304.   FRAME is a frame object,
  6305.   ALIST is an association list specifying some of FRAME's parameters, and
  6306.   WINDOW-CONFIG is a window configuration object for FRAME.Fset-frame-configuration
  6307. Restore the frames to the state described by CONFIGURATION.
  6308. Each frame listed in CONFIGURATION has its position, size, window
  6309. configuration, and other parameters set as specified in CONFIGURATION.
  6310. Ordinarily, this function deletes all existing frames not
  6311. listed in CONFIGURATION.  But if optional second argument NODELETE
  6312. is given and non-nil, the unwanted frames are iconified instead.Fframe-height
  6313. Return number of lines available for display on FRAME.
  6314. If FRAME is omitted, describe the currently selected frame.Fframe-width
  6315. Return number of columns available for display on FRAME.
  6316. If FRAME is omitted, describe the currently selected frame.Fset-default-font
  6317. Set the font of the selected frame to FONT.
  6318. When called interactively, prompt for the name of the font to use.Fset-background-color
  6319. Set the background color of the selected frame to COLOR.
  6320. When called interactively, prompt for the name of the color to use.Fset-foreground-color
  6321. Set the foreground color of the selected frame to COLOR.
  6322. When called interactively, prompt for the name of the color to use.Fset-cursor-color
  6323. Set the text cursor color of the selected frame to COLOR.
  6324. When called interactively, prompt for the name of the color to use.Fset-mouse-color
  6325. Set the color of the mouse pointer of the selected frame to COLOR.
  6326. When called interactively, prompt for the name of the color to use.Fset-border-color
  6327. Set the color of the border of the selected frame to COLOR.
  6328. When called interactively, prompt for the name of the color to use.Fauto-raise-mode
  6329. Toggle whether or not the selected frame should auto-raise.
  6330. With arg, turn auto-raise mode on if and only if arg is positive.
  6331. Note that this controls Emacs's own auto-raise feature.
  6332. Some window managers allow you to enable auto-raise for certain windows.
  6333. You can use that for Emacs windows if you wish, but if you do,
  6334. that is beyond the control of Emacs and this command has no effect on it.Fauto-lower-mode
  6335. Toggle whether or not the selected frame should auto-lower.
  6336. With arg, turn auto-lower mode on if and only if arg is positive.
  6337. Note that this controls Emacs's own auto-lower feature.
  6338. Some window managers allow you to enable auto-lower for certain windows.
  6339. You can use that for Emacs windows if you wish, but if you do,
  6340. that is beyond the control of Emacs and this command has no effect on it.Ftoggle-scroll-bar
  6341. Toggle whether or not the selected frame has vertical scroll bars.
  6342. With arg, turn vertical scroll bars on if and only if arg is positive.Ftoggle-horizontal-scroll-bar
  6343. Toggle whether or not the selected frame has horizontal scroll bars.
  6344. With arg, turn horizontal scroll bars on if and only if arg is positive.
  6345. Horizontal scroll bars aren't implemented yet.Fset-screen-width
  6346. Obsolete function to change the size of the screen to COLS columns.
  6347. Optional second arg non-nil means that redisplay should use COLS columns
  6348. but that the idea of the actual width of the frame should not be changed.
  6349. This function is provided only for compatibility with Emacs 18; new code
  6350. should use `set-frame-width instead'.Fset-screen-height
  6351. Obsolete function to change the height of the screen to LINES lines.
  6352. Optional second arg non-nil means that redisplay should use LINES lines
  6353. but that the idea of the actual height of the screen should not be changed.
  6354. This function is provided only for compatibility with Emacs 18; new code
  6355. should use `set-frame-width' instead.Vctl-x-5-map
  6356. Keymap for frame commands.Vbuffers-menu-max-size
  6357. *Maximum number of entries which may appear on the Buffers menu.
  6358. If this is 10, then only the ten most-recently-selected buffers are shown.
  6359. If this is nil, then all buffers are shown.
  6360. A large number or nil slows down menu responsiveness.Fnonincremental-search-forward
  6361. Read a string and search for it nonincrementally.Fnonincremental-search-backward
  6362. Read a string and search backward for it nonincrementally.Fnonincremental-re-search-forward
  6363. Read a regular expression and search for it nonincrementally.Fnonincremental-re-search-backward
  6364. Read a regular expression and search backward for it nonincrementally.Fnonincremental-repeat-search-forward
  6365. Search forward for the previous search string.Fnonincremental-repeat-search-backward
  6366. Search backward for the previous search string.Fnonincremental-repeat-re-search-forward
  6367. Search forward for the previous regular expression.Fnonincremental-repeat-re-search-backward
  6368. Search backward for the previous regular expression.Fclipboard-yank
  6369. Reinsert the last stretch of killed text, or the clipboard contents.Fclipboard-kill-ring-save
  6370. Copy region to kill ring, and save in the X clipboard.Fclipboard-kill-region
  6371. Kill the region, and save it in the X clipboard.Fmenu-bar-enable-clipboard
  6372. Make CUT, PASTE and COPY (keys and menu bar items) use the clipboard.
  6373. Do the same for the keys of the same name.Fkill-this-buffer
  6374. Kills the current buffer.Fdelete-frame-enabled-p
  6375. Return non-nil if `delete-frame' should be enabled in the menu bar.Vyank-menu-length
  6376. *Maximum length to display in the yank-menu.Fmenu-bar-mode
  6377. Toggle display of a menu bar on each frame.
  6378. This command applies to all frames that exist and frames to be
  6379. created in the future.
  6380. With a numeric argument, if the argument is negative,
  6381. turn off menu bars; otherwise, turn on menu bars.Vmouse-yank-at-point
  6382. *If non-nil, mouse yank commands yank at point instead of at click.Fmouse-major-mode-menu
  6383. Pop up a mode-specific menu of mouse commands.Fmouse-delete-window
  6384. Delete the window you click on.
  6385. This must be bound to a mouse click.Fmouse-select-window
  6386. Select the window clicked on; don't move point.Fmouse-tear-off-window
  6387. Delete the window clicked on, and create a new frame displaying its buffer.Fmouse-delete-other-windows
  6388. Delete all window except the one you click on.Fmouse-split-window-vertically
  6389. Select Emacs window mouse is on, then split it vertically in half.
  6390. The window is split at the line clicked on.
  6391. This command must be bound to a mouse click.Fmouse-split-window-horizontally
  6392. Select Emacs window mouse is on, then split it horizontally in half.
  6393. The window is split at the column clicked on.
  6394. This command must be bound to a mouse click.Fmouse-drag-mode-line
  6395. Change the height of a window by dragging on the mode line.Fmouse-drag-vertical-line
  6396. Change the width of a window by dragging on the vertical line.Fmouse-set-point
  6397. Move point to the position clicked on with the mouse.
  6398. This should be bound to a mouse click event type.Fmouse-region-match
  6399. Return non-nil if there's an active region that was set with the mouse.Fmouse-set-region
  6400. Set the region to the text dragged over, and copy to kill ring.
  6401. This should be bound to a mouse drag event.Vmouse-scroll-delay
  6402. *The pause between scroll steps caused by mouse drags, in seconds.
  6403. If you drag the mouse beyond the edge of a window, Emacs scrolls the
  6404. window to bring the text beyond that edge into view, with a delay of
  6405. this many seconds between scroll steps.  Scrolling stops when you move
  6406. the mouse back into the window, or release the button.
  6407. This variable's value may be non-integral.
  6408. Setting this to zero causes Emacs to scroll as fast as it can.Vmouse-scroll-min-lines
  6409. *The minimum number of lines scrolled by dragging mouse out of window.
  6410. Moving the mouse out the top or bottom edge of the window begins
  6411. scrolling repeatedly.  The number of lines scrolled per repetition
  6412. is normally equal to the number of lines beyond the window edge that
  6413. the mouse has moved.  However, it always scrolls at least the number
  6414. of lines specified by this variable.Fmouse-scroll-subr
  6415. Scroll the window WINDOW, JUMP lines at a time, until new input arrives.
  6416. If OVERLAY is an overlay, let it stretch from START to the far edge of
  6417. the newly visible text.
  6418. Upon exit, point is at the far edge of the newly visible text.Fmouse-drag-region
  6419. Set the region to the text that the mouse is dragged over.
  6420. Highlight the drag area as you move the mouse.
  6421. This must be bound to a button-down mouse event.
  6422. In Transient Mark mode, the highlighting remains as long as the mark
  6423. remains active.  Otherwise, it remains until the next input event.Fmouse-skip-word
  6424. Skip over word, over whitespace, or over identical punctuation.
  6425. If DIR is positive skip forward; if negative, skip backward.Fmouse-set-mark
  6426. Set mark at the position clicked on with the mouse.
  6427. Display cursor at that position for a second.
  6428. This must be bound to a mouse click.Fmouse-kill
  6429. Kill the region between point and the mouse click.
  6430. The text is saved in the kill ring, as with \[kill-region].Fmouse-yank-at-click
  6431. Insert the last stretch of killed text at the position clicked on.
  6432. Also move point to one end of the text thus inserted (normally the end).
  6433. Prefix arguments are interpreted as with \[yank].
  6434. If `mouse-yank-at-point' is non-nil, insert at point
  6435. regardless of where you click.Fmouse-kill-ring-save
  6436. Copy the region between point and the mouse click in the kill ring.
  6437. This does not delete the region; it acts like \[kill-ring-save].Fmouse-save-then-kill
  6438. Save text to point in kill ring; the second time, kill the text.
  6439. If the text between point and the mouse is the same as what's
  6440. at the front of the kill ring, this deletes the text.
  6441. Otherwise, it adds the text to the kill ring, like \[kill-ring-save],
  6442. which prepares for a second click to delete the text.
  6443.  
  6444. If you have selected words or lines, this command extends the
  6445. selection through the word or line clicked on.  If you do this
  6446. again in a different position, it extends the selection again.
  6447. If you do this twice in the same position, the selection is killed.Fmouse-start-secondary
  6448. Set one end of the secondary selection to the position clicked on.
  6449. Use \[mouse-secondary-save-then-kill] to set the other end
  6450. and complete the secondary selection.Fmouse-set-secondary
  6451. Set the secondary selection to the text that the mouse is dragged over.
  6452. This must be bound to a mouse drag event.Fmouse-drag-secondary
  6453. Set the secondary selection to the text that the mouse is dragged over.
  6454. Highlight the drag area as you move the mouse.
  6455. This must be bound to a button-down mouse event.Fmouse-yank-secondary
  6456. Insert the secondary selection at the position clicked on.
  6457. Move point to the end of the inserted text.
  6458. If `mouse-yank-at-point' is non-nil, insert at point
  6459. regardless of where you click.Fmouse-kill-secondary
  6460. Kill the text in the secondary selection.
  6461. This is intended more as a keyboard command than as a mouse command
  6462. but it can work as either one.
  6463.  
  6464. The current buffer (in case of keyboard use), or the buffer clicked on,
  6465. must be the one that the secondary selection is in.  This requirement
  6466. is to prevent accidents.Fmouse-secondary-save-then-kill
  6467. Save text to point in kill ring; the second time, kill the text.
  6468. You must use this in a buffer where you have recently done \[mouse-start-secondary].
  6469. If the text between where you did \[mouse-start-secondary] and where
  6470. you use this command matches the text at the front of the kill ring,
  6471. this command deletes the text.
  6472. Otherwise, it adds the text to the kill ring, like \[kill-ring-save],
  6473. which prepares for a second click with this command to delete the text.
  6474.  
  6475. If you have already made a secondary selection in that buffer,
  6476. this command extends or retracts the selection to where you click.
  6477. If you do this again in a different position, it extends or retracts
  6478. again.  If you do this twice in the same position, it kills the selection.Vmouse-menu-buffer-maxlen
  6479. *Number of buffers in one pane (submenu) of the buffer menu.
  6480. If we have lots of buffers, divide them into groups of
  6481. `mouse-menu-buffer-maxlen' and make a pane (or submenu) for each one.Fmouse-buffer-menu
  6482. Pop up a menu of buffers for selection with the mouse.
  6483. This switches buffers in the window that you clicked on,
  6484. and selects that window.Fmouse-choose-completion
  6485. Click on an alternative in the `*Completions*' buffer to choose it.Vx-fixed-font-alist
  6486. X fonts suitable for use in Emacs.Fmouse-set-font
  6487. Select an emacs font from a list of known good fontsFx-get-selection
  6488. Return the value of an X Windows selection.
  6489. The argument TYPE (default `PRIMARY') says which selection, 
  6490. and the argument DATA-TYPE (default `STRING') says how to convert the data.Fx-get-clipboard
  6491. Return text pasted to the clipboard.Fx-set-selection
  6492. Make an X Windows selection of type TYPE and value DATA.
  6493. The argument TYPE (default `PRIMARY') says which selection, 
  6494. and DATA specifies the contents.  DATA may be a string,
  6495. a symbol, an integer (or a cons of two integers or list of two integers).
  6496.  
  6497. The selection may also be a cons of two markers pointing to the same buffer,
  6498. or an overlay.  In these cases, the selection is considered to be the text 
  6499. between the markers *at whatever time the selection is examined*.
  6500. Thus, editing done in the buffer after you specify the selection
  6501. can alter the effective value of the selection.
  6502.  
  6503. The data may also be a vector of valid non-vector selection values.
  6504.  
  6505. Interactively, the text of the region is used as the selection value.Fx-get-cut-buffer
  6506. Returns the value of one of the 8 X server cut-buffers.  Optional arg
  6507. WHICH-ONE should be a number from 0 to 7, defaulting to 0.
  6508. Cut buffers are considered obsolete; you should use selections instead.Fx-set-cut-buffer
  6509. Store STRING into the X server's primary cut buffer.
  6510. If PUSH is non-nil, also rotate the cut buffers:
  6511. this means the previous value of the primary cut buffer moves the second
  6512. cut buffer, and the second to the third, and so on (there are 8 buffers.)
  6513. Cut buffers are considered obsolete; you should use selections instead.Fxselect-convert-to-class
  6514. EmacsFxselect-convert-to-name
  6515. emacsFscroll-bar-event-ratio
  6516. Given a scroll bar event EVENT, return the scroll bar position as a ratio.
  6517. The value is a cons cell (PORTION . WHOLE) containing two integers
  6518. whose ratio gives the event's vertical position in the scroll bar, with 0
  6519. referring to the top and 1 to the bottom.Fscroll-bar-scale
  6520. Given a pair (NUM . DENOM) and WHOLE, return (/ (* NUM WHOLE) DENOM).
  6521. This is handy for scaling a position on a scroll bar into real units,
  6522. like buffer positions.  If SCROLL-BAR-POS is the (PORTION . WHOLE) pair
  6523. from a scroll bar event, then (scroll-bar-scale SCROLL-BAR-POS
  6524. (buffer-size)) is the position in the current buffer corresponding to
  6525. that scroll bar position.Fscroll-bar-mode
  6526. Toggle display of vertical scroll bars on each frame.
  6527. This command applies to all frames that exist and frames to be
  6528. created in the future.
  6529. With a numeric argument, if the argument is negative,
  6530. turn off scroll bars; otherwise, turn on scroll bars.Fscroll-bar-set-window-start
  6531. Set the window start according to where the scroll bar is dragged.
  6532. EVENT should be a scroll bar click or drag event.Fscroll-bar-drag-position
  6533. Calculate new window start for drag event.Fscroll-bar-maybe-set-window-start
  6534. Set the window start according to where the scroll bar is dragged.
  6535. Only change window start if the new start is substantially different.
  6536. EVENT should be a scroll bar click or drag event.Fscroll-bar-drag
  6537. Scroll the window by dragging the scroll bar slider.
  6538. If you click outside the slider, the window scrolls to bring the slider there.Fscroll-bar-scroll-down
  6539. Scroll the window's top line down to the location of the scroll bar click.
  6540. EVENT should be a scroll bar click.Fscroll-bar-scroll-up
  6541. Scroll the line next to the scroll bar click to the top of the window.
  6542. EVENT should be a scroll bar click.Vls-lisp-support-shell-wildcards
  6543. *Non-nil means file patterns are treated as shell wildcards.
  6544. nil means they are treated as Emacs regexps (for backward compatibility).
  6545. This variable is checked by \[insert-directory] only when `ls-lisp.el'
  6546. package is used.Finsert-directory
  6547. Insert directory listing for FILE, formatted according to SWITCHES.
  6548. Leaves point after the inserted text.
  6549. Optional third arg WILDCARD means treat FILE as shell wildcard.
  6550. Optional fourth arg FULL-DIRECTORY-P means file is a directory and
  6551. switches do not contain `d', so that a full listing is expected.
  6552.  
  6553. This version of the function comes from `ls-lisp.el'.  It doesn not
  6554. run any external programs or shells.  It supports ordinary shell
  6555. wildcards if `ls-lisp-support-shell-wildcards' variable is non-nil;
  6556. otherwise, it interprets wildcards as regular expressions to match
  6557. file names.
  6558.  
  6559. Not all `ls' switches are supported.  The switches that work
  6560. are: A a c i r S s t uVemx-emacs-version
  6561. Last (third) version number of this port of Emacs for emx.Freplace-char-in-string
  6562. Replace in string STR character C1 with character C2 and return STR.
  6563. This function does *not* copy the string.Femx-backslashify
  6564. Return a new string, replacing forward slashes in STRING with backslashes.Vforce-fat-regexp
  6565. *Regexp used by `force-fat-p' to detect path names which are on FAT
  6566. file systems which are not detected by `file-name-valid-p'.
  6567. Letter case is ignored.Fforce-fat-p
  6568. Return non-nil if FN matches `force-fat-regexp'.Fmake-legal-file-name
  6569. Turn FN into a legal file name and return the modified copy of the string.
  6570. The characters * and ? will be replaced with _.Fmake-auto-save-file-name
  6571. Return file name to use for auto-saves of current buffer.
  6572. Does not consider `auto-save-visited-file-name' as that variable is checked
  6573. before calling this function.  This has been redefined for customization.
  6574. See also `auto-save-file-name-p'.Fmake-backup-file-name
  6575. Create the non-numeric backup file name for FILE.
  6576. This is a separate function so you can redefine it for customization.Fsplit-file-name
  6577. Split NAME into directory part, base name part and extension.
  6578. Return a list containing three elements. If a part is empty, the list element
  6579. is nil.Fadd-to-fat-file-name
  6580. Concatenate PREFIX, FILE and SUFFIX, then make it FAT compatible.
  6581. It is assumed that FILE is already compatible with the FAT file system.Ffind-file-binary
  6582. Edit binary file FILENAME.
  6583. Switch to a buffer visiting binary file FILENAME,
  6584. creating one if none already exists.Femx-make-TeX-command
  6585. Build a command which runs TeX with arguments CMD.
  6586. Prefix CMD with the value of `emx-TeX-command', inserting the cmd.exe
  6587. escape character `^' if TeX-Shell equals "cmd.exe" and the first
  6588. non-option word of CMD starts with `&'.Vshell-command-handler-alist
  6589. *Alist of elements (NAME . HANDLER) for shell commands handled specially.
  6590. If the base name of a shell command is equal to NAME, then HANDLER is
  6591. called by pnhc-shell-command.  The handler receives six arguments:
  6592. a list consisting of the primitive and its additional arguments (see
  6593. program-name-handler-alist for details); the file name of the shell;
  6594. the program name handler; the complete shell command; the substring
  6595. of the shell command preceding the program name; and the substring
  6596. of the shell command following the program name.Vpnh-shell-pre-processor-alist
  6597. *Alist of elements (REGEXP . FUNCTION) for pre-processing shell commands.
  6598. If a shell command matches REGEXP, then FUNCTION is called by
  6599. pnhc-shell-command.  The function receives one argument, the shell command.
  6600. The function returns the pre-processed shell command.
  6601. This variable is used for shells handled by pnh-shell.Vpnh-cmdproc-pre-processor-alist
  6602. *Alist of elements (REGEXP . FUNCTION) for pre-processing shell commands.
  6603. If a shell command matches REGEXP, then FUNCTION is called by
  6604. pnhc-shell-command.  The function receives one argument, the shell command.
  6605. The function returns the pre-processed shell command.
  6606. This variable is used for shells handled by pnh-cmdproc.Vpnh-shell-post-processor-alist
  6607. *Alist of elements (REGEXP . FUNCTION) for post-processing shell commands.
  6608. If a shell command matches REGEXP, then FUNCTION is called by
  6609. pnhc-shell-command.  The function receives one argument, the shell command.
  6610. The function returns the post-processed shell command.
  6611. This variable is used for shells handled by pnh-shell.Vpnh-cmdproc-post-processor-alist
  6612. *Alist of elements (REGEXP . FUNCTION) for post-processing shell commands.
  6613. If a shell command matches REGEXP, then FUNCTION is called by
  6614. pnhc-shell-command.  The function receives one argument, the shell command.
  6615. The function returns the post-processed shell command.
  6616. This variable is used for shells handled by pnh-cmdproc.Vtcp-binary-process-input-services
  6617. *List of services for which binary-process-input should be set to t.
  6618. The elements are service names or port numbers, as strings.Vtcp-binary-process-output-services
  6619. *List of services for which binary-process-output should be set to t.
  6620. The elements are service names or port numbers, as strings.Fswitch-to-other-buffer
  6621. Switch to the previous buffer.Fcmd
  6622. Run CMD.EXE with I/O through buffer *cmd*.Femx-forward-to-word
  6623. Move forward until encountering the beginning of a word.
  6624. With argument, do this that many times.Femx-backward-to-word
  6625. Move backward until encountering the beginning of a word.
  6626. With argument, do this that many times.Femx-beginning-of-buffer
  6627. Move to the beginning of the buffer without setting mark.Femx-end-of-buffer
  6628. Move to end of the buffer without setting mark.Femx-scroll-line-up
  6629. Scroll up by one line.
  6630. With argument, do this that many times.Femx-scroll-line-down
  6631. Scroll down by one line.
  6632. With argument, do this that many times.Femx-kill-left-line
  6633. Kill from the beginning of the line to point.Femx-kill-word
  6634. Delete characters until encountering the beginning of a word.
  6635. With argument, do this that many times.Femx-copy-line-as-kill
  6636. Copy current line as kill.
  6637. With argument, copy that many lines starting with the current line.Femx-dup-line
  6638. Duplicate current line.
  6639. Set mark to the beginning of the new line.
  6640. With argument, do this that many times.Femx-copy-region
  6641. Copy region to point.
  6642. With argument, do this that many times.Femx-yank-line
  6643. Yank as line: Move to beginning of current line and yank.
  6644. Insert newline if not present. The argument is passed to the yank command.Femx-match-paren
  6645. Go to the matching parenthesis if on parenthesis.
  6646. This function uses the syntax table.Femx-toggle-case-fold-search
  6647. Toggle and display the case-fold-search variable.Vemx-search-string
  6648. Search string for emx-search-forward and emx-search-backward.Vemx-search-re
  6649. Non-nil means use regular expression for emx-search-forward and -backward.Vemx-search-goto-first-line
  6650. *Non-nil means display match at the top of the window.Femx-search-forward
  6651. Search forward for a string.
  6652. If prefixed by \[universal-argument], ask for search string.
  6653. If prefixed by \[universal-argument] \[universal-argument], use regular expression.Femx-search-backward
  6654. Search backward for a string.
  6655. If prefixed by \[universal-argument], ask for search string.
  6656. If prefixed by \[universal-argument] \[universal-argument], use
  6657. regular expression.Femx-search-fb
  6658. Search forward or backward for a string.
  6659. If the first argument is nil, ask for the string.
  6660. The second argument is search-forward or search-backward.
  6661. The third argument is re-search-forward or re-search-backward.
  6662. See also the documentation of the emx-search-goto-first-line variable.Femx-search-forward-at-point
  6663. Search forward for name around or before point.Femx-search-backward-at-point
  6664. Search backward for name around or before point.Femx-search-forward-region
  6665. Search forward for string given by region.
  6666. With prefix arg, use regular expression.Femx-search-backward-region
  6667. Search backward for string given by region.
  6668. With prefix arg, use regular expression.Femx-buffer-file-name
  6669. Display the name of the file visited in current buffer.Femx-extract-file-name
  6670. Return the file name around or before point.
  6671. If AT-POINT is not nil, the file names starts at point, that is, characters
  6672. before point are ignored.Femx-find-file-at-point
  6673. Find file whose name is around or before point.
  6674. With prefix argument find file whose name starts at point.Femx-find-file-region
  6675. Find file whose name is given by region.Femx-fill-paragraph
  6676. Fill paragraph at or before point using em's notion of a paragraph.
  6677. Prefix arg means justify as well.
  6678. Paragraphs are separated by blank lines. The indentation of the first
  6679. line is used for indenting the entire paragraph. If there are two
  6680. consecutive blanks (or a tab) in the first line of the paragraphs,
  6681. everything to the left of these blanks (or the tab) is left as-is and
  6682. the paragraph is indented to the first non-blank character after the
  6683. first two consecutive blanks of the first line.Vemx-add-number
  6684. The number used by the emx-add-number command.Vemx-add-number-adjust
  6685. *Non-nil if emx-add-number should adjust columns.
  6686. This is done by adding or removing blanks if the length of the number
  6687. has changed.Femx-add-number
  6688. Add a constant to the decimal number at point.
  6689. With prefix arg, add that constant. Otherwise add previously used constant.
  6690. If there is no previous constant, ask for the constant. To make emx-add-number
  6691. ask for a number, use a prefix arg of zero (M-0).
  6692. The constant is stored in the emx-add-number variable.
  6693.  
  6694. If emx-add-number-adjust is non-nil, blanks are added or removed to keep
  6695. columns aligned if the length of the number in the buffer has changed by
  6696. adding the constant.
  6697.  
  6698. This command is useful for moving controls by adding to coordinates in .rc
  6699. files.Femx-add-number-2
  6700. Add NUMBER to the number at point.Femx-toggle-debug-on-error
  6701. Toggle and display the debug-on-error variable.Femx-toggle-truncate-lines
  6702. Toggle and display the truncate-lines variable.Femx-toggle-sentence-end-double-space
  6703. Toggle and display the `sentence-end-double-space' variable.Femx-function-key
  6704. Define a PC function key.
  6705. CODE is the scan code, EVENT is the event for that key (a vector).Vonly-global-abbrevs
  6706. *t means user plans to use global abbrevs only.
  6707. Makes the commands to define mode-specific abbrevs define global ones instead.Fabbrev-mode
  6708. Toggle abbrev mode.
  6709. With argument ARG, turn abbrev mode on iff ARG is positive.
  6710. In abbrev mode, inserting an abbreviation causes it to expand
  6711. and be replaced by its expansion.Vedit-abbrevs-map
  6712. Keymap used in edit-abbrevs.Fkill-all-abbrevs
  6713. Undefine all defined abbrevs.Finsert-abbrevs
  6714. Insert after point a description of all defined abbrevs.
  6715. Mark is set after the inserted text.Flist-abbrevs
  6716. Display a list of all defined abbrevs.Fedit-abbrevs-mode
  6717. Major mode for editing the list of abbrev definitions.
  6718. \{edit-abbrevs-map}Fedit-abbrevs
  6719. Alter abbrev definitions by editing a list of them.
  6720. Selects a buffer containing a list of abbrev definitions.
  6721. You can edit them and type \<edit-abbrevs-map>\[edit-abbrevs-redefine] to redefine abbrevs
  6722. according to your editing.
  6723. Buffer contains a header line for each abbrev table,
  6724.  which is the abbrev table name in parentheses.
  6725. This is followed by one line per abbrev in that table:
  6726. NAME   USECOUNT   EXPANSION   HOOK
  6727. where NAME and EXPANSION are strings with quotes,
  6728. USECOUNT is an integer, and HOOK is any valid function
  6729. or may be omitted (it is usually omitted).Fedit-abbrevs-redefine
  6730. Redefine abbrevs according to current buffer contents.Fdefine-abbrevs
  6731. Define abbrevs according to current visible buffer contents.
  6732. See documentation of `edit-abbrevs' for info on the format of the
  6733. text you must have in the buffer.
  6734. With argument, eliminate all abbrev definitions except
  6735. the ones defined from the buffer now.Fread-abbrev-file
  6736. Read abbrev definitions from file written with `write-abbrev-file'.
  6737. Optional argument FILE is the name of the file to read;
  6738. it defaults to the value of `abbrev-file-name'.
  6739. Optional second argument QUIETLY non-nil means don't print anything.Fquietly-read-abbrev-file
  6740. Read abbrev definitions from file written with write-abbrev-file.
  6741. Optional argument FILE is the name of the file to read;
  6742. it defaults to the value of `abbrev-file-name'.
  6743. Does not print anything.Fwrite-abbrev-file
  6744. Write all abbrev definitions to a file of Lisp code.
  6745. The file written can be loaded in another session to define the same abbrevs.
  6746. The argument FILE is the file name to write.Fadd-mode-abbrev
  6747. Define mode-specific abbrev for last word(s) before point.
  6748. Argument is how many words before point form the expansion;
  6749. or zero means the region is the expansion.
  6750. A negative argument means to undefine the specified abbrev.
  6751. Reads the abbreviation in the minibuffer.
  6752.  
  6753. Don't use this function in a Lisp program; use `define-abbrev' instead.Fadd-global-abbrev
  6754. Define global (all modes) abbrev for last word(s) before point.
  6755. The prefix argument specifies the number of words before point that form the
  6756. expansion; or zero means the region is the expansion.
  6757. A negative argument means to undefine the specified abbrev.
  6758. This command uses the minibuffer to read the abbreviation.
  6759.  
  6760. Don't use this function in a Lisp program; use `define-abbrev' instead.Finverse-add-mode-abbrev
  6761. Define last word before point as a mode-specific abbrev.
  6762. With prefix argument N, defines the Nth word before point.
  6763. This command uses the minibuffer to read the expansion.
  6764. Expands the abbreviation after defining it.Finverse-add-global-abbrev
  6765. Define last word before point as a global (mode-independent) abbrev.
  6766. With prefix argument N, defines the Nth word before point.
  6767. This command uses the minibuffer to read the expansion.
  6768. Expands the abbreviation after defining it.Fabbrev-prefix-mark
  6769. Mark current point as the beginning of an abbrev.
  6770. Abbrev to be expanded starts here rather than at beginning of word.
  6771. This way, you can expand an abbrev with a prefix: insert the prefix,
  6772. use this command, then insert the abbrev.Fexpand-region-abbrevs
  6773. For abbrev occurrence in the region, offer to expand it.
  6774. The user is asked to type y or n for each occurrence.
  6775. A prefix argument means don't query; expand all abbrevs.
  6776. If called from a Lisp program, arguments are START END &optional NOQUERY.VBuffer-menu-mode-map
  6777. FBuffer-menu-mode
  6778. Major mode for editing a list of buffers.
  6779. Each line describes one of the buffers in Emacs.
  6780. Letters do not insert themselves; instead, they are commands.
  6781. \<Buffer-menu-mode-map>
  6782. \[Buffer-menu-mouse-select] -- select buffer you click on, in place of the buffer menu.
  6783. \[Buffer-menu-this-window] -- select current line's buffer in place of the buffer menu.
  6784. \[Buffer-menu-other-window] -- select that buffer in another window,
  6785.   so the buffer menu buffer remains visible in its window.
  6786. \[Buffer-menu-switch-other-window] -- make another window display that buffer.
  6787. \[Buffer-menu-mark] -- mark current line's buffer to be displayed.
  6788. \[Buffer-menu-select] -- select current line's buffer.
  6789.   Also show buffers marked with m, in other windows.
  6790. \[Buffer-menu-1-window] -- select that buffer in full-frame window.
  6791. \[Buffer-menu-2-window] -- select that buffer in one window,
  6792.   together with buffer selected before this one in another window.
  6793. \[Buffer-menu-visit-tags-table] -- visit-tags-table this buffer.
  6794. \[Buffer-menu-not-modified] -- clear modified-flag on that buffer.
  6795. \[Buffer-menu-save] -- mark that buffer to be saved, and move down.
  6796. \[Buffer-menu-delete] -- mark that buffer to be deleted, and move down.
  6797. \[Buffer-menu-delete-backwards] -- mark that buffer to be deleted, and move up.
  6798. \[Buffer-menu-execute] -- delete or save marked buffers.
  6799. \[Buffer-menu-unmark] -- remove all kinds of marks from current line.
  6800.   With prefix argument, also move up one line.
  6801. \[Buffer-menu-backup-unmark] -- back up a line and remove marks.
  6802. \[Buffer-menu-toggle-read-only] -- toggle read-only status of buffer on this line.FBuffer-menu-buffer
  6803. Return buffer described by this line of buffer menu.Fbuffer-menu
  6804. Make a menu of buffers so you can save, delete or select them.
  6805. With argument, show only buffers that are visiting files.
  6806. Type ? after invocation to get help on commands available.
  6807. Type q immediately to make the buffer menu go away.Fbuffer-menu-other-window
  6808. Display a list of buffers in another window.
  6809. With the buffer list buffer, you can save, delete or select the buffers.
  6810. With argument, show only buffers that are visiting files.
  6811. Type ? after invocation to get help on commands available.
  6812. Type q immediately to make the buffer menu go away.FBuffer-menu-quit
  6813. Quit the buffer menu.FBuffer-menu-mark
  6814. Mark buffer on this line for being displayed by \<Buffer-menu-mode-map>\[Buffer-menu-select] command.FBuffer-menu-unmark
  6815. Cancel all requested operations on buffer on this line and move down.
  6816. Optional ARG means move up.FBuffer-menu-backup-unmark
  6817. Move up and cancel all requested operations on buffer on line above.FBuffer-menu-delete
  6818. Mark buffer on this line to be deleted by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command.
  6819. Prefix arg is how many buffers to delete.
  6820. Negative arg means delete backwards.FBuffer-menu-delete-backwards
  6821. Mark buffer on this line to be deleted by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command
  6822. and then move up one line.  Prefix arg means move that many lines.FBuffer-menu-save
  6823. Mark buffer on this line to be saved by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command.FBuffer-menu-not-modified
  6824. Mark buffer on this line as unmodified (no changes to save).FBuffer-menu-execute
  6825. Save and/or delete buffers marked with \<Buffer-menu-mode-map>\[Buffer-menu-save] or \<Buffer-menu-mode-map>\[Buffer-menu-delete] commands.FBuffer-menu-select
  6826. Select this line's buffer; also display buffers marked with `>'.
  6827. You can mark buffers with the \<Buffer-menu-mode-map>\[Buffer-menu-mark] command.
  6828. This command deletes and replaces all the previously existing windows
  6829. in the selected frame.FBuffer-menu-visit-tags-table
  6830. Visit the tags table in the buffer on this line.  See `visit-tags-table'.FBuffer-menu-1-window
  6831. Select this line's buffer, alone, in full frame.FBuffer-menu-mouse-select
  6832. Select the buffer whose line you click on.FBuffer-menu-this-window
  6833. Select this line's buffer in this window.FBuffer-menu-other-window
  6834. Select this line's buffer in other window, leaving buffer menu visible.FBuffer-menu-switch-other-window
  6835. Make the other window select this line's buffer.
  6836. The current window remains selected.FBuffer-menu-2-window
  6837. Select this line's buffer, with previous buffer in second window.FBuffer-menu-toggle-read-only
  6838. Toggle read-only status of buffer on this line, perhaps via version control.Flist-buffers
  6839. Display a list of names of existing buffers.
  6840. The list is displayed in a buffer named `*Buffer List*'.
  6841. Note that buffers with names starting with spaces are omitted.
  6842. Non-null optional arg FILES-ONLY means mention only file buffers.
  6843.  
  6844. The M column contains a * for buffers that are modified.
  6845. The R column contains a % for buffers that are read-only.Flist-buffers-noselect
  6846. Create and return a buffer with a list of names of existing buffers.
  6847. The buffer is named `*Buffer List*'.
  6848. Note that buffers with names starting with spaces are omitted.
  6849. Non-null optional arg FILES-ONLY means mention only file buffers.
  6850.  
  6851. The M column contains a * for buffers that are modified.
  6852. The R column contains a % for buffers that are read-only.Fdefsubst
  6853. Define an inline function.  The syntax is just like that of `defun'.Fmake-obsolete
  6854. Make the byte-compiler warn that FUNCTION is obsolete.
  6855. The warning will say that NEW should be used instead.
  6856. If NEW is a string, that is the `use instead' message.Fmake-obsolete-variable
  6857. Make the byte-compiler warn that VARIABLE is obsolete,
  6858. and NEW should be used instead.  If NEW is a string, then that is the
  6859. `use instead' message.Fdont-compile
  6860. Like `progn', but the body always runs interpreted (not compiled).
  6861. If you think you need this, you're probably making a mistake somewhere.Feval-when-compile
  6862. Like `progn', but evaluates the body at compile time.
  6863. The result of the body appears to the compiler as a quoted constant.Feval-and-compile
  6864. Like `progn', but evaluates the body at compile time and at load time.Vdelete-auto-save-files
  6865. *Non-nil means delete auto-save file when a buffer is saved or killed.Vdirectory-abbrev-alist
  6866. *Alist of abbreviations for file directories.
  6867. A list of elements of the form (FROM . TO), each meaning to replace
  6868. FROM with TO when it appears in a directory name.  This replacement is
  6869. done when setting up the default directory of a newly visited file.
  6870. *Every* FROM string should start with `^'.
  6871.  
  6872. Do not use `~' in the TO strings.
  6873. They should be ordinary absolute directory names.
  6874.  
  6875. Use this feature when you have directories which you normally refer to
  6876. via absolute symbolic links.  Make TO the name of the link, and FROM
  6877. the name it is linked to.Vmake-backup-files
  6878. *Non-nil means make a backup of a file the first time it is saved.
  6879. This can be done by renaming the file or by copying.
  6880.  
  6881. Renaming means that Emacs renames the existing file so that it is a
  6882. backup file, then writes the buffer into a new file.  Any other names
  6883. that the old file had will now refer to the backup file.  The new file
  6884. is owned by you and its group is defaulted.
  6885.  
  6886. Copying means that Emacs copies the existing file into the backup
  6887. file, then writes the buffer on top of the existing file.  Any other
  6888. names that the old file had will now refer to the new (edited) file.
  6889. The file's owner and group are unchanged.
  6890.  
  6891. The choice of renaming or copying is controlled by the variables
  6892. `backup-by-copying', `backup-by-copying-when-linked' and
  6893. `backup-by-copying-when-mismatch'.  See also `backup-inhibited'.Vbackup-inhibited
  6894. Non-nil means don't make a backup, regardless of the other parameters.
  6895. This variable is intended for use by making it local to a buffer.
  6896. But it is local only if you make it local.Vbackup-by-copying
  6897. *Non-nil means always use copying to create backup files.
  6898. See documentation of variable `make-backup-files'.Vbackup-by-copying-when-linked
  6899. *Non-nil means use copying to create backups for files with multiple names.
  6900. This causes the alternate names to refer to the latest version as edited.
  6901. This variable is relevant only if `backup-by-copying' is nil.Vbackup-by-copying-when-mismatch
  6902. *Non-nil means create backups by copying if this preserves owner or group.
  6903. Renaming may still be used (subject to control of other variables)
  6904. when it would not result in changing the owner or group of the file;
  6905. that is, for files which are owned by you and whose group matches
  6906. the default for a new file created there by you.
  6907. This variable is relevant only if `backup-by-copying' is nil.Vbackup-enable-predicate
  6908. Predicate that looks at a file name and decides whether to make backups.
  6909. Called with an absolute file name as argument, it returns t to enable backup.Vbuffer-offer-save
  6910. *Non-nil in a buffer means offer to save the buffer on exit
  6911. even if the buffer is not visiting a file.
  6912. Automatically local in all buffers.Vfind-file-existing-other-name
  6913. *Non-nil means find a file under alternative names, in existing buffers.
  6914. This means if any existing buffer is visiting the file you want
  6915. under another name, you get the existing buffer instead of a new buffer.Vfind-file-visit-truename
  6916. *Non-nil means visit a file under its truename.
  6917. The truename of a file is found by chasing all links
  6918. both at the file level and at the levels of the containing directories.Vbuffer-file-number
  6919. The device number and file number of the file visited in the current buffer.
  6920. The value is a list of the form (FILENUM DEVNUM).
  6921. This pair of numbers uniquely identifies the file.
  6922. If the buffer is visiting a new file, the value is nil.Vbuffer-file-numbers-unique
  6923. Non-nil means that buffer-file-number uniquely identifies files.Vfile-precious-flag
  6924. *Non-nil means protect against I/O errors while saving files.
  6925. Some modes set this non-nil in particular buffers.
  6926.  
  6927. This feature works by writing the new contents into a temporary file
  6928. and then renaming the temporary file to replace the original.
  6929. In this way, any I/O error in writing leaves the original untouched,
  6930. and there is never any instant where the file is nonexistent.
  6931.  
  6932. Note that this feature forces backups to be made by copying.
  6933. Yet, at the same time, saving a precious file
  6934. breaks any hard links between it and other files.Vversion-control
  6935. *Control use of version numbers for backup files.
  6936. t means make numeric backup versions unconditionally.
  6937. nil means make them for files that have some already.
  6938. `never' means do not make them.Vdired-kept-versions
  6939. *When cleaning directory, number of versions to keep.Vdelete-old-versions
  6940. *If t, delete excess backup versions silently.
  6941. If nil, ask confirmation.  Any other value prevents any trimming.Vkept-old-versions
  6942. *Number of oldest versions to keep when a new numbered backup is made.Vkept-new-versions
  6943. *Number of newest versions to keep when a new numbered backup is made.
  6944. Includes the new backup.  Must be > 0Vrequire-final-newline
  6945. *Value of t says silently ensure a file ends in a newline when it is saved.
  6946. Non-nil but not t says ask user whether to add a newline when there isn't one.
  6947. nil means don't add newlines.Vauto-save-default
  6948. *Non-nil says by default do auto-saving of every file-visiting buffer.Vauto-save-visited-file-name
  6949. *Non-nil says auto-save a buffer in the file it is visiting, when practical.
  6950. Normally auto-save files are written under other names.Vsave-abbrevs
  6951. *Non-nil means save word abbrevs too when files are saved.
  6952. Loading an abbrev file sets this to t.Vfind-file-run-dired
  6953. *Non-nil says run dired if `find-file' is given the name of a directory.Vfind-file-not-found-hooks
  6954. List of functions to be called for `find-file' on nonexistent file.
  6955. These functions are called as soon as the error is detected.
  6956. `buffer-file-name' is already set up.
  6957. The functions are called in the order given until one of them returns non-nil.Vfind-file-hooks
  6958. List of functions to be called after a buffer is loaded from a file.
  6959. The buffer's local variables (if any) will have been processed before the
  6960. functions are called.Vwrite-file-hooks
  6961. List of functions to be called before writing out a buffer to a file.
  6962. If one of them returns non-nil, the file is considered already written
  6963. and the rest are not called.
  6964. These hooks are considered to pertain to the visited file.
  6965. So this list is cleared if you change the visited file name.
  6966.  
  6967. Don't make this variable buffer-local; instead, use `local-write-file-hooks'.
  6968. See also `write-contents-hooks'.Vlocal-write-file-hooks
  6969. Just like `write-file-hooks', except intended for per-buffer use.
  6970. The functions in this list are called before the ones in
  6971. `write-file-hooks'.
  6972.  
  6973. This variable is meant to be used for hooks that have to do with a
  6974. particular visited file.  Therefore, it is a permanent local, so that
  6975. changing the major mode does not clear it.  However, calling
  6976. `set-visited-file-name' does clear it.Vwrite-contents-hooks
  6977. List of functions to be called before writing out a buffer to a file.
  6978. If one of them returns non-nil, the file is considered already written
  6979. and the rest are not called.
  6980.  
  6981. This variable is meant to be used for hooks that pertain to the
  6982. buffer's contents, not to the particular visited file; thus,
  6983. `set-visited-file-name' does not clear this variable; but changing the
  6984. major mode does clear it.
  6985.  
  6986. This variable automatically becomes buffer-local whenever it is set.
  6987. If you use `add-hooks' to add elements to the list, use nil for the
  6988. LOCAL argument.
  6989.  
  6990. See also `write-file-hooks'.Venable-local-variables
  6991. *Control use of local-variables lists in files you visit.
  6992. The value can be t, nil or something else.
  6993. A value of t means local-variables lists are obeyed;
  6994. nil means they are ignored; anything else means query.
  6995.  
  6996. The command \[normal-mode] always obeys local-variables lists
  6997. and ignores this variable.Venable-local-eval
  6998. *Control processing of the "variable" `eval' in a file's local variables.
  6999. The value can be t, nil or something else.
  7000. A value of t means obey `eval' variables;
  7001. nil means ignore them; anything else means query.
  7002.  
  7003. The command \[normal-mode] always obeys local-variables lists
  7004. and ignores this variable.Fconvert-standard-filename
  7005. Convert a standard file's name to something suitable for the current OS.
  7006. This function's standard definition is trivial; it just returns the argument.
  7007. However, on some systems, the function is redefined
  7008. with a definition that really does change some file names.Fpwd
  7009. Show the current default directory.Vcd-path
  7010. Value of the CDPATH environment variable, as a list.
  7011. Not actually set up until the first time you you use it.Vpath-separator
  7012. Character used to separate concatenated paths.Fparse-colon-path
  7013. Explode a colon-separated list of paths into a string list.Fcd-absolute
  7014. Change current directory to given absolute file name DIR.Fcd
  7015. Make DIR become the current buffer's default directory.
  7016. If your environment includes a `CDPATH' variable, try each one of that
  7017. colon-separated list of directories when resolving a relative directory name.Fload-file
  7018. Load the Lisp file named FILE.Fload-library
  7019. Load the library named LIBRARY.
  7020. This is an interface to the function `load'.Ffile-local-copy
  7021. Copy the file FILE into a temporary file on this machine.
  7022. Returns the name of the local copy, or nil, if FILE is directly
  7023. accessible.Ffile-truename
  7024. Return the truename of FILENAME, which should be absolute.
  7025. The truename of a file name is found by chasing symbolic links
  7026. both at the level of the file and at the level of the directories
  7027. containing it, until no links are left at any level.
  7028.  
  7029. The arguments COUNTER and PREV-DIRS are used only in recursive calls.
  7030. Do not specify them in other calls.Ffile-chase-links
  7031. Chase links in FILENAME until a name that is not a link.
  7032. Does not examine containing directories for links,
  7033. unlike `file-truename'.Fswitch-to-buffer-other-window
  7034. Select buffer BUFFER in another window.Fswitch-to-buffer-other-frame
  7035. Switch to buffer BUFFER in another frame.Ffind-file
  7036. Edit file FILENAME.
  7037. Switch to a buffer visiting file FILENAME,
  7038. creating one if none already exists.Ffind-file-other-window
  7039. Edit file FILENAME, in another window.
  7040. May create a new window, or reuse an existing one.
  7041. See the function `display-buffer'.Ffind-file-other-frame
  7042. Edit file FILENAME, in another frame.
  7043. May create a new frame, or reuse an existing one.
  7044. See the function `display-buffer'.Ffind-file-read-only
  7045. Edit file FILENAME but don't allow changes.
  7046. Like \[find-file] but marks buffer as read-only.
  7047. Use \[toggle-read-only] to permit editing.Ffind-file-read-only-other-window
  7048. Edit file FILENAME in another window but don't allow changes.
  7049. Like \[find-file-other-window] but marks buffer as read-only.
  7050. Use \[toggle-read-only] to permit editing.Ffind-file-read-only-other-frame
  7051. Edit file FILENAME in another frame but don't allow changes.
  7052. Like \[find-file-other-frame] but marks buffer as read-only.
  7053. Use \[toggle-read-only] to permit editing.Ffind-alternate-file-other-window
  7054. Find file FILENAME as a replacement for the file in the next window.
  7055. This command does not select that window.Ffind-alternate-file
  7056. Find file FILENAME, select its buffer, kill previous buffer.
  7057. If the current buffer now contains an empty file that you just visited
  7058. (presumably by mistake), use this command to visit the file you really want.Fcreate-file-buffer
  7059. Create a suitably named buffer for visiting FILENAME, and return it.
  7060. FILENAME (sans directory) is used unchanged if that name is free;
  7061. otherwise a string <2> or <3> or ... is appended to get an unused name.Fgenerate-new-buffer
  7062. Create and return a buffer with a name based on NAME.
  7063. Choose the buffer's name using `generate-new-buffer-name'.Vautomount-dir-prefix
  7064. Regexp to match the automounter prefix in a directory name.Vabbreviated-home-dir
  7065. The user's homedir abbreviated according to `directory-abbrev-list'.Fabbreviate-file-name
  7066. Return a version of FILENAME shortened using `directory-abbrev-alist'.
  7067. This also substitutes "~" for the user's home directory.
  7068. Type \[describe-variable] directory-abbrev-alist RET for more information.Vfind-file-not-true-dirname-list
  7069. *List of logical names for which visiting shouldn't save the true dirname.
  7070. On VMS, when you visit a file using a logical name that searches a path,
  7071. you may or may not want the visited file name to record the specific
  7072. directory where the file was found.  If you *do not* want that, add the logical
  7073. name to this list as a string.Ffind-buffer-visiting
  7074. Return the buffer visiting file FILENAME (a string).
  7075. This is like `get-file-buffer', except that it checks for any buffer
  7076. visiting the same file, possibly under a different name.
  7077. If there is no such live buffer, return nil.Finsert-file-contents-literally
  7078. Like `insert-file-contents', q.v., but only reads in the file.
  7079. A buffer may be modified in several ways after reading into the buffer due
  7080. to advanced Emacs features, such as file-name-handlers, format decoding,
  7081. find-file-hooks, etc.
  7082.   This function ensures that none of these modifications will take place.Ffind-file-noselect
  7083. Read file FILENAME into a buffer and return the buffer.
  7084. If a buffer exists visiting FILENAME, return that one, but
  7085. verify that the file has not changed since visited or saved.
  7086. The buffer is not selected, just returned to the caller.Fafter-find-file
  7087. Called after finding a file and by the default revert function.
  7088. Sets buffer mode, parses local variables.
  7089. Optional args ERROR, WARN, and NOAUTO: ERROR non-nil means there was an
  7090. error in reading the file.  WARN non-nil means warn if there
  7091. exists an auto-save file more recent than the visited file.
  7092. NOAUTO means don't mess with auto-save mode.
  7093. Fourth arg AFTER-FIND-FILE-FROM-REVERT-BUFFER non-nil
  7094.  means this call was from `revert-buffer'.
  7095. Fifth arg NOMODES non-nil means don't alter the file's modes.
  7096. Finishes by calling the functions in `find-file-hooks'
  7097. unless NOMODES is non-nil.Fnormal-mode
  7098. Choose the major mode for this buffer automatically.
  7099. Also sets up any specified local variables of the file.
  7100. Uses the visited file name, the -*- line, and the local variables spec.
  7101.  
  7102. This function is called automatically from `find-file'.  In that case,
  7103. we may set up specified local variables depending on the value of
  7104. `enable-local-variables': if it is t, we do; if it is nil, we don't;
  7105. otherwise, we query.  `enable-local-variables' is ignored if you
  7106. run `normal-mode' explicitly.Vauto-mode-alist
  7107. Alist of filename patterns vs corresponding major mode functions.
  7108. Each element looks like (REGEXP . FUNCTION) or (REGEXP FUNCTION NON-NIL).
  7109. (NON-NIL stands for anything that is not nil; the value does not matter.)
  7110. Visiting a file whose name matches REGEXP specifies FUNCTION as the
  7111. mode function to use.  FUNCTION will be called, unless it is nil.
  7112.  
  7113. If the element has the form (REGEXP FUNCTION NON-NIL), then after
  7114. calling FUNCTION (if it's not nil), we delete the suffix that matched
  7115. REGEXP and search the list again for another match.Vinterpreter-mode-alist
  7116. Alist mapping interpreter names to major modes.
  7117. This alist applies to files whose first line starts with `#!'.
  7118. Each element looks like (INTERPRETER . MODE).
  7119. The car of each element is compared with
  7120. the name of the interpreter specified in the first line.
  7121. If it matches, mode MODE is selected.Vinhibit-first-line-modes-regexps
  7122. List of regexps; if one matches a file name, don't look for `-*-'.Vinhibit-first-line-modes-suffixes
  7123. List of regexps for what to ignore, for `inhibit-first-line-modes-regexps'.
  7124. When checking `inhibit-first-line-modes-regexps', we first discard
  7125. from the end of the file name anything that matches one of these regexps.Vuser-init-file
  7126. File name including directory of user's initialization file.Fset-auto-mode
  7127. Select major mode appropriate for current buffer.
  7128. This checks for a -*- mode tag in the buffer's text,
  7129. compares the filename against the entries in `auto-mode-alist',
  7130. or checks the interpreter that runs this file against
  7131. `interpreter-mode-alist'.
  7132.  
  7133. It does not check for the `mode:' local variable in the
  7134. Local Variables section of the file; for that, use `hack-local-variables'.
  7135.  
  7136. If `enable-local-variables' is nil, this function does not check for a
  7137. -*- mode tag.Vhack-local-variables-hook
  7138. Normal hook run after processing a file's local variables specs.
  7139. Major modes can use this to examine user-specified local variables
  7140. in order to initialize other data structure based on them.Fhack-local-variables
  7141. Parse and put into effect this buffer's local variables spec.Vignored-local-variables
  7142. Variables to be ignored in a file's local variable spec.Fset-visited-file-name
  7143. Change name of file visited in current buffer to FILENAME.
  7144. The next time the buffer is saved it will go in the newly specified file.
  7145. nil or empty string as argument means make buffer not be visiting any file.
  7146. Remember to delete the initial contents of the minibuffer
  7147. if you wish to pass an empty string as the argument.
  7148.  
  7149. The optional second argument NO-QUERY, if non-nil, inhibits asking for
  7150. confirmation in the case where the file FILENAME already exists.Fwrite-file
  7151. Write current buffer into file FILENAME.
  7152. Makes buffer visit that file, and marks it not modified.
  7153. If the buffer is already visiting a file, you can specify
  7154. a directory name as FILENAME, to write a file of the same
  7155. old name in that directory.
  7156.  
  7157. If optional second arg CONFIRM is non-nil,
  7158. ask for confirmation for overwriting an existing file.
  7159. Interactively, confirmation is required unless you supply a prefix argument.Fbackup-buffer
  7160. Make a backup of the disk file visited by the current buffer, if appropriate.
  7161. This is normally done before saving the buffer the first time.
  7162. If the value is non-nil, it is the result of `file-modes' on the original
  7163. file; this means that the caller, after saving the buffer, should change
  7164. the modes of the new file to agree with the old modes.Ffile-name-sans-versions
  7165. Return FILENAME sans backup versions or strings.
  7166. This is a separate procedure so your site-init or startup file can
  7167. redefine it.
  7168. If the optional argument KEEP-BACKUP-VERSION is non-nil,
  7169. we do not remove backup version numbers, only true file version numbers.Ffile-ownership-preserved-p
  7170. Returns t if deleting FILE and rewriting it would preserve the owner.Ffile-name-sans-extension
  7171. Return FILENAME sans final "extension".
  7172. The extension, in a file name, is the part that follows the last `.'.Fmake-backup-file-name
  7173. Create the non-numeric backup file name for FILE.
  7174. This is a separate function so you can redefine it for customization.Fbackup-file-name-p
  7175. Return non-nil if FILE is a backup file name (numeric or not).
  7176. This is a separate function so you can redefine it for customization.
  7177. You may need to redefine `file-name-sans-versions' as well.Fbackup-extract-version
  7178. Given the name of a numeric backup file, return the backup number.
  7179. Uses the free variable `bv-length', whose value should be
  7180. the index in the name where the version number begins.Ffind-backup-file-name
  7181. Find a file name for a backup file, and suggestions for deletions.
  7182. Value is a list whose car is the name for the backup file
  7183.  and whose cdr is a list of old versions to consider deleting now.
  7184. If the value is nil, don't make a backup.Ffile-nlinks
  7185. Return number of names file FILENAME has.Ffile-relative-name
  7186. Convert FILENAME to be relative to DIRECTORY (default: default-directory).Fsave-buffer
  7187. Save current buffer in visited file if modified.  Versions described below.
  7188. By default, makes the previous version into a backup file
  7189.  if previously requested or if this is the first save.
  7190. With 1 \[universal-argument], marks this version
  7191.  to become a backup when the next save is done.
  7192. With 2 \[universal-argument]'s,
  7193.  unconditionally makes the previous version into a backup file.
  7194. With 3 \[universal-argument]'s, marks this version
  7195.  to become a backup when the next save is done,
  7196.  and unconditionally makes the previous version into a backup file.
  7197.  
  7198. With argument of 0, never makes the previous version into a backup file.
  7199.  
  7200. If a file's name is FOO, the names of its numbered backup versions are
  7201.  FOO.~i~ for various integers i.  A non-numbered backup file is called FOO~.
  7202. Numeric backups (rather than FOO~) will be made if value of
  7203.  `version-control' is not the atom `never' and either there are already
  7204.  numeric versions of the file being backed up, or `version-control' is
  7205.  non-nil.
  7206. We don't want excessive versions piling up, so there are variables
  7207.  `kept-old-versions', which tells Emacs how many oldest versions to keep,
  7208.  and `kept-new-versions', which tells how many newest versions to keep.
  7209.  Defaults are 2 old versions and 2 new.
  7210. `dired-kept-versions' controls dired's clean-directory (.) command.
  7211. If `delete-old-versions' is nil, system will query user
  7212.  before trimming versions.  Otherwise it does it silently.Fdelete-auto-save-file-if-necessary
  7213. Delete auto-save file for current buffer if `delete-auto-save-files' is t.
  7214. Normally delete only if the file was written by this Emacs since
  7215. the last real save, but optional arg FORCE non-nil means delete anyway.Vafter-save-hook
  7216. Normal hook that is run after a buffer is saved to its file.Fbasic-save-buffer
  7217. Save the current buffer in its visited file, if it has been modified.
  7218. After saving the buffer, run `after-save-hook'.Fsave-some-buffers
  7219. Save some modified file-visiting buffers.  Asks user about each one.
  7220. Optional argument (the prefix) non-nil means save all with no questions.
  7221. Optional second argument EXITING means ask about certain non-file buffers
  7222.  as well as about file buffers.Fnot-modified
  7223. Mark current buffer as unmodified, not needing to be saved.
  7224. With prefix arg, mark buffer as modified, so \[save-buffer] will save.
  7225.  
  7226. It is not a good idea to use this function in Lisp programs, because it
  7227. prints a message in the minibuffer.  Instead, use `set-buffer-modified-p'.Ftoggle-read-only
  7228. Change whether this buffer is visiting its file read-only.
  7229. With arg, set read-only iff arg is positive.Finsert-file
  7230. Insert contents of file FILENAME into buffer after point.
  7231. Set mark after the inserted text.
  7232.  
  7233. This function is meant for the user to run interactively.
  7234. Don't call it from programs!  Use `insert-file-contents' instead.
  7235. (Its calling sequence is different; see its documentation).Fappend-to-file
  7236. Append the contents of the region to the end of file FILENAME.
  7237. When called from a function, expects three arguments,
  7238. START, END and FILENAME.  START and END are buffer positions
  7239. saying what text to write.Ffile-newest-backup
  7240. Return most recent backup file for FILENAME or nil if no backups exist.Frename-uniquely
  7241. Rename current buffer to a similar name not already taken.
  7242. This function is useful for creating multiple shell process buffers
  7243. or multiple mail buffers, etc.Fmake-directory
  7244. Create the directory DIR and any nonexistent parent dirs.
  7245. Interactively, the default choice of directory to create
  7246. is the current default directory for file names.
  7247. That is useful when you have visited a file in a nonexistent directory.
  7248.  
  7249. Noninteractively, the second (optional) argument PARENTS says whether
  7250. to create parent directories if they don't exist.Vrevert-buffer-function
  7251. Function to use to revert this buffer, or nil to do the default.
  7252. The function receives two arguments IGNORE-AUTO and NOCONFIRM,
  7253. which are the arguments that `revert-buffer' received.Vrevert-buffer-insert-file-contents-function
  7254. Function to use to insert contents when reverting this buffer.
  7255. Gets two args, first the nominal file name to use,
  7256. and second, t if reading the auto-save file.Vbefore-revert-hook
  7257. Normal hook for `revert-buffer' to run before reverting.
  7258. If `revert-buffer-function' is used to override the normal revert
  7259. mechanism, this hook is not used.Vafter-revert-hook
  7260. Normal hook for `revert-buffer' to run after reverting.
  7261. Note that the hook value that it runs is the value that was in effect
  7262. before reverting; that makes a difference if you have buffer-local
  7263. hook functions.
  7264.  
  7265. If `revert-buffer-function' is used to override the normal revert
  7266. mechanism, this hook is not used.Frevert-buffer
  7267. Replace the buffer text with the text of the visited file on disk.
  7268. This undoes all changes since the file was visited or saved.
  7269. With a prefix argument, offer to revert from latest auto-save file, if
  7270. that is more recent than the visited file.
  7271.  
  7272. When called from Lisp, the first argument is IGNORE-AUTO; only offer
  7273. to revert from the auto-save file when this is nil.  Note that the
  7274. sense of this argument is the reverse of the prefix argument, for the
  7275. sake of backward compatibility.  IGNORE-AUTO is optional, defaulting
  7276. to nil.
  7277.  
  7278. Optional second argument NOCONFIRM means don't ask for confirmation at
  7279. all.
  7280.  
  7281. If the value of `revert-buffer-function' is non-nil, it is called to
  7282. do the work.
  7283.  
  7284. The default revert function runs the hook `before-revert-hook' at the
  7285. beginning and `after-revert-hook' at the end.Frecover-file
  7286. Visit file FILE, but get contents from its last auto-save file.Frecover-session
  7287. Recover auto save files from a previous Emacs session.
  7288. This command first displays a Dired buffer showing you the
  7289. previous sessions that you could recover from.
  7290. To choose one, move point to the proper line and then type C-c C-c.
  7291. Then you'll be asked about a number of files to recover.Frecover-session-finish
  7292. Choose one saved session to recover auto-save files from.
  7293. This command is used in the special Dired buffer created by
  7294. \[recover-session].Fkill-some-buffers
  7295. For each buffer, ask whether to kill it.Fauto-save-mode
  7296. Toggle auto-saving of contents of current buffer.
  7297. With prefix argument ARG, turn auto-saving on if positive, else off.Frename-auto-save-file
  7298. Adjust current buffer's auto save file name for current conditions.
  7299. Also rename any existing auto save file, if it was made in this session.Fmake-auto-save-file-name
  7300. Return file name to use for auto-saves of current buffer.
  7301. Does not consider `auto-save-visited-file-name' as that variable is checked
  7302. before calling this function.  You can redefine this for customization.
  7303. See also `auto-save-file-name-p'.Fauto-save-file-name-p
  7304. Return non-nil if FILENAME can be yielded by `make-auto-save-file-name'.
  7305. FILENAME should lack slashes.  You can redefine this for customization.Fwildcard-to-regexp
  7306. Given a shell file name pattern WILDCARD, return an equivalent regexp.
  7307. The generated regexp will match a filename iff the filename
  7308. matches that wildcard according to shell rules.  Only wildcards known
  7309. by `sh' are supported.Vlist-directory-brief-switches
  7310. *Switches for list-directory to pass to `ls' for brief listing,Vlist-directory-verbose-switches
  7311. *Switches for list-directory to pass to `ls' for verbose listing,Flist-directory
  7312. Display a list of files in or matching DIRNAME, a la `ls'.
  7313. DIRNAME is globbed by the shell if necessary.
  7314. Prefix arg (second arg if noninteractive) means supply -l switch to `ls'.
  7315. Actions controlled by variables `list-directory-brief-switches'
  7316. and `list-directory-verbose-switches'.Vinsert-directory-program
  7317. Absolute or relative name of the `ls' program used by `insert-directory'.Finsert-directory
  7318. Insert directory listing for FILE, formatted according to SWITCHES.
  7319. Leaves point after the inserted text.
  7320. SWITCHES may be a string of options, or a list of strings.
  7321. Optional third arg WILDCARD means treat FILE as shell wildcard.
  7322. Optional fourth arg FULL-DIRECTORY-P means file is a directory and
  7323. switches do not contain `d', so that a full listing is expected.
  7324.  
  7325. This works by running a directory listing program
  7326. whose name is in the variable `insert-directory-program'.
  7327. If WILDCARD, it also runs the shell specified by `shell-file-name'.Vkill-emacs-query-functions
  7328. Functions to call with no arguments to query about killing Emacs.
  7329. If any of these functions returns nil, killing Emacs is cancelled.
  7330. `save-buffers-kill-emacs' (\[save-buffers-kill-emacs]) calls these functions,
  7331. but `kill-emacs', the low level primitive, does not.
  7332. See also `kill-emacs-hook'.Fsave-buffers-kill-emacs
  7333. Offer to save each buffer, then kill this Emacs process.
  7334. With prefix arg, silently save all file-visiting buffers, then kill.Vfill-individual-varying-indent
  7335. *Controls criterion for a new paragraph in `fill-individual-paragraphs'.
  7336. Non-nil means changing indent doesn't end a paragraph.
  7337. That mode can handle paragraphs with extra indentation on the first line,
  7338. but it requires separator lines between paragraphs.
  7339. A value of nil means that any change in indentation starts a new paragraph.Vsentence-end-double-space
  7340. *Non-nil means a single space does not end a sentence.Vcolon-double-space
  7341. *Non-nil means put two spaces after a colon when filling.Vfill-paragraph-function
  7342. Mode-specific function to fill a paragraph, or nil if there is none.
  7343. If the function returns nil, then `fill-paragraph' does its normal work.Fset-fill-prefix
  7344. Set the fill prefix to the current line up to point.
  7345. Filling expects lines to start with the fill prefix and
  7346. reinserts the fill prefix in each resulting line.Vadaptive-fill-mode
  7347. *Non-nil means determine a paragraph's fill prefix from its text.Vadaptive-fill-regexp
  7348. *Regexp to match text at start of line that constitutes indentation.
  7349. If Adaptive Fill mode is enabled, whatever text matches this pattern
  7350. on the second line of a paragraph is used as the standard indentation
  7351. for the paragraph.  If the paragraph has just one line, the indentation
  7352. is taken from that line.Vadaptive-fill-function
  7353. *Function to call to choose a fill prefix for a paragraph.
  7354. This function is used when `adaptive-fill-regexp' does not match.Fcurrent-fill-column
  7355. Return the fill-column to use for this line.
  7356. The fill-column to use for a buffer is stored in the variable `fill-column',
  7357. but can be locally modified by the `right-margin' text property, which is
  7358. subtracted from `fill-column'.
  7359.  
  7360. The fill column to use for a line is the first column at which the column
  7361. number equals or exceeds the local fill-column - right-margin difference.Fcanonically-space-region
  7362. Remove extra spaces between words in region.
  7363. Leave one space between words, two at end of sentences or after colons
  7364. (depending on values of `sentence-end-double-space' and `colon-double-space').
  7365. Remove indentation from each line.Ffill-context-prefix
  7366. Compute a fill prefix from the text between FROM and TO.
  7367. This uses the variables `adaptive-fill-prefix' and `adaptive-fill-function'.
  7368. If FIRST-LINE-REGEXP is non-nil, then when taking a prefix from the
  7369. first line, insist it must match FIRST-LINE-REGEXP.Ffill-region-as-paragraph
  7370. Fill the region as one paragraph.
  7371. It removes any paragraph breaks in the region and extra newlines at the end,
  7372. indents and fills lines between the margins given by the
  7373. `current-left-margin' and `current-fill-column' functions.
  7374. It leaves point at the beginning of the line following the paragraph.
  7375.  
  7376. Normally performs justification according to the `current-justification'
  7377. function, but with a prefix arg, does full justification instead.
  7378.  
  7379. From a program, optional third arg JUSTIFY can specify any type of
  7380. justification.  Fourth arg NOSQUEEZE non-nil means not to make spaces
  7381. between words canonical before filling.  Fifth arg SQUEEZE-AFTER, if non-nil,
  7382. means don't canonicalize spaces before that position.
  7383.  
  7384. If `sentence-end-double-space' is non-nil, then period followed by one
  7385. space does not end a sentence, so don't break a line there.Ffill-paragraph
  7386. Fill paragraph at or after point.  Prefix arg means justify as well.
  7387. If `sentence-end-double-space' is non-nil, then period followed by one
  7388. space does not end a sentence, so don't break a line there.
  7389.  
  7390. If `fill-paragraph-function' is non-nil, we call it (passing our
  7391. argument to it), and if it returns non-nil, we simply return its value.Ffill-region
  7392. Fill each of the paragraphs in the region.
  7393. Prefix arg (non-nil third arg, if called from program) means justify as well.
  7394.  
  7395. Noninteractively, fourth arg NOSQUEEZE non-nil means to leave
  7396. whitespace other than line breaks untouched, and fifth arg TO-EOP
  7397. non-nil means to keep filling to the end of the paragraph (or next
  7398. hard newline, if `use-hard-newlines' is on).
  7399.  
  7400. If `sentence-end-double-space' is non-nil, then period followed by one
  7401. space does not end a sentence, so don't break a line there.Vdefault-justification
  7402. *Method of justifying text not otherwise specified.
  7403. Possible values are `left', `right', `full', `center', or `none'.
  7404. The requested kind of justification is done whenever lines are filled.
  7405. The `justification' text-property  can locally override this variable.
  7406. This variable automatically becomes buffer-local when set in any fashion.Fcurrent-justification
  7407. How should we justify this line?
  7408. This returns the value of the text-property `justification',
  7409. or the variable `default-justification' if there is no text-property.
  7410. However, it returns nil rather than `none' to mean "don't justify".Fset-justification
  7411. Set the region's justification style.
  7412. The kind of justification to use is prompted for.
  7413. If the mark is not active, this command operates on the current paragraph.
  7414. If the mark is active, the region is used.  However, if the beginning and end
  7415. of the region are not at paragraph breaks, they are moved to the beginning and
  7416. end of the paragraphs they are in.
  7417. If `use-hard-newlines' is true, all hard newlines are taken to be paragraph
  7418. breaks.
  7419.  
  7420. When calling from a program, operates just on region between BEGIN and END,
  7421. unless optional fourth arg WHOLE-PAR is non-nil.  In that case bounds are
  7422. extended to include entire paragraphs as in the interactive command.Fset-justification-none
  7423. Disable automatic filling for paragraphs in the region.
  7424. If the mark is not active, this applies to the current paragraph.Fset-justification-left
  7425. Make paragraphs in the region left-justified.
  7426. This is usually the default, but see the variable `default-justification'.
  7427. If the mark is not active, this applies to the current paragraph.Fset-justification-right
  7428. Make paragraphs in the region right-justified:
  7429. Flush at the right margin and ragged on the left.
  7430. If the mark is not active, this applies to the current paragraph.Fset-justification-full
  7431. Make paragraphs in the region fully justified:
  7432. This makes lines flush on both margins by inserting spaces between words.
  7433. If the mark is not active, this applies to the current paragraph.Fset-justification-center
  7434. Make paragraphs in the region centered.
  7435. If the mark is not active, this applies to the current paragraph.Fjustify-current-line
  7436. Do some kind of justification on this line.
  7437. Normally does full justification: adds spaces to the line to make it end at
  7438. the column given by `current-fill-column'.
  7439. Optional first argument HOW specifies alternate type of justification:
  7440. it can be `left', `right', `full', `center', or `none'.  
  7441. If HOW is t, will justify however the `current-justification' function says to.
  7442. If HOW is nil or missing, full justification is done by default.
  7443. Second arg EOP non-nil means that this is the last line of the paragraph, so
  7444. it will not be stretched by full justification.
  7445. Third arg NOSQUEEZE non-nil means to leave interior whitespace unchanged,
  7446. otherwise it is made canonical.Funjustify-current-line
  7447. Remove justification whitespace from current line.
  7448. If the line is centered or right-justified, this function removes any
  7449. indentation past the left margin.  If the line is full-justified, it removes
  7450. extra spaces between words.  It does nothing in other justification modes.Funjustify-region
  7451. Remove justification whitespace from region.
  7452. For centered or right-justified regions, this function removes any indentation
  7453. past the left margin from each line.  For full-justified lines, it removes 
  7454. extra spaces between words.  It does nothing in other justification modes.
  7455. Arguments BEGIN and END are optional; default is the whole buffer.Ffill-nonuniform-paragraphs
  7456. Fill paragraphs within the region, allowing varying indentation within each.
  7457. This command divides the region into "paragraphs",
  7458. only at paragraph-separator lines, then fills each paragraph
  7459. using as the fill prefix the smallest indentation of any line
  7460. in the paragraph.
  7461.  
  7462. When calling from a program, pass range to fill as first two arguments.
  7463.  
  7464. Optional third and fourth arguments JUSTIFY and MAIL-FLAG:
  7465. JUSTIFY to justify paragraphs (prefix arg),
  7466. MAIL-FLAG for a mail message, i. e. don't fill header lines.Ffill-individual-paragraphs
  7467. Fill paragraphs of uniform indentation within the region.
  7468. This command divides the region into "paragraphs", 
  7469. treating every change in indentation level as a paragraph boundary,
  7470. then fills each paragraph using its indentation level as the fill prefix.
  7471.  
  7472. When calling from a program, pass range to fill as first two arguments.
  7473.  
  7474. Optional third and fourth arguments JUSTIFY and MAIL-FLAG:
  7475. JUSTIFY to justify paragraphs (prefix arg),
  7476. MAIL-FLAG for a mail message, i. e. don't fill header lines.Vformat-alist
  7477. List of information about understood file formats.
  7478. Elements are of the form (NAME DOC-STR REGEXP FROM-FN TO-FN MODIFY MODE-FN).
  7479. NAME    is a symbol, which is stored in `buffer-file-format'.
  7480. DOC-STR should be a single line providing more information about the
  7481.         format.  It is currently unused, but in the future will be shown to
  7482.         the user if they ask for more information.
  7483. REGEXP  is a regular expression to match against the beginning of the file;
  7484.         it should match only files in that format.
  7485. FROM-FN is called to decode files in that format; it gets two args, BEGIN 
  7486.         and END, and can make any modifications it likes, returning the new
  7487.         end.  It must make sure that the beginning of the file no longer
  7488.         matches REGEXP, or else it will get called again.
  7489. TO-FN   is called to encode a region into that format; it is also passed BEGIN
  7490.         and END, and either returns a list of annotations like
  7491.         `write-region-annotate-functions', or modifies the region and returns
  7492.         the new end.
  7493. MODIFY, if non-nil, means the TO-FN modifies the region.  If nil, TO-FN may
  7494.         not make any changes and should return a list of annotations.
  7495. MODE-FN, if specified, is called when visiting a file with that format.Fformat-annotate-function
  7496. Returns annotations for writing region as FORMAT.
  7497. FORMAT is a symbol naming one of the formats defined in `format-alist',
  7498. it must be a single symbol, not a list like `buffer-file-format'.
  7499. This function works like a function on `write-region-annotate-functions':
  7500. it either returns a list of annotations, or returns with a different buffer
  7501. current, which contains the modified text to write.
  7502.  
  7503. For most purposes, consider using `format-encode-region' instead.Fformat-decode
  7504. Decode text from any known FORMAT.
  7505. FORMAT is a symbol appearing in `format-alist' or a list of such symbols, 
  7506. or nil, in which case this function tries to guess the format of the data by
  7507. matching against the regular expressions in `format-alist'.  After a match is
  7508. found and the region decoded, the alist is searched again from the beginning
  7509. for another match.
  7510.  
  7511. Second arg LENGTH is the number of characters following point to operate on.
  7512. If optional third arg VISIT-FLAG is true, set `buffer-file-format'
  7513. to the list of formats used, and call any mode functions defined for those
  7514. formats.
  7515.  
  7516. Returns the new length of the decoded region.
  7517.  
  7518. For most purposes, consider using `format-decode-region' instead.Fformat-decode-buffer
  7519. Translate the buffer from some FORMAT.
  7520. If the format is not specified, this function attempts to guess.
  7521. `buffer-file-format' is set to the format used, and any mode-functions 
  7522. for the format are called.Fformat-decode-region
  7523. Decode the region from some format.
  7524. Arg FORMAT is optional; if omitted the format will be determined by looking
  7525. for identifying regular expressions at the beginning of the region.Fformat-encode-buffer
  7526. Translate the buffer into FORMAT.
  7527. FORMAT defaults to `buffer-file-format'.  It is a symbol naming one of the
  7528. formats defined in `format-alist', or a list of such symbols.Fformat-encode-region
  7529. Translate the region into some FORMAT.
  7530. FORMAT defaults to `buffer-file-format', it is a symbol naming
  7531. one of the formats defined in `format-alist', or a list of such symbols.Fformat-write-file
  7532. Write current buffer into a FILE using some FORMAT.
  7533. Makes buffer visit that file and sets the format as the default for future
  7534. saves.  If the buffer is already visiting a file, you can specify a directory
  7535. name as FILE, to write a file of the same old name in that directory.Fformat-find-file
  7536. Find the file FILE using data format FORMAT.
  7537. If FORMAT is nil then do not do any format conversion.Fformat-insert-file
  7538. Insert the contents of file FILE using data format FORMAT.
  7539. If FORMAT is nil then do not do any format conversion.
  7540. The optional third and fourth arguments BEG and END specify
  7541. the part of the file to read.
  7542.  
  7543. The return value is like the value of `insert-file-contents':
  7544. a list (ABSOLUTE-FILE-NAME . SIZE).Fformat-read
  7545. Read and return the name of a format.
  7546. Return value is a list, like `buffer-file-format'; it may be nil.
  7547. Formats are defined in `format-alist'.  Optional arg is the PROMPT to use.Fformat-replace-strings
  7548. Do multiple replacements on the buffer.
  7549. ALIST is a list of (from . to) pairs, which should be proper arguments to
  7550. `search-forward' and `replace-match' respectively.
  7551. Optional 2nd arg REVERSE, if non-nil, means the pairs are (to . from), so that
  7552. you can use the same list in both directions if it contains only literal
  7553. strings. 
  7554. Optional args BEGIN and END specify a region of the buffer to operate on.Fformat-delq-cons
  7555. Remove the given CONS from LIST by side effect,
  7556. and return the new LIST.  Since CONS could be the first element 
  7557. of LIST, write `(setq foo (format-delq-cons element foo))' to be sure of 
  7558. changing the value of `foo'.Fformat-make-relatively-unique
  7559. Delete common elements of lists A and B, return as pair.
  7560. Compares using `equal'.Fformat-common-tail
  7561. Given two lists that have a common tail, return it.
  7562. Compares with `equal', and returns the part of A that is equal to the
  7563. equivalent part of B.  If even the last items of the two are not equal,
  7564. returns nil.Fformat-reorder
  7565. Arrange ITEMS to following partial ORDER.
  7566. Elements of ITEMS equal to elements of ORDER will be rearranged to follow the
  7567. ORDER.  Unmatched items will go last.Fformat-deannotate-region
  7568. Translate annotations in the region into text properties.
  7569. This sets text properties between FROM to TO as directed by the 
  7570. TRANSLATIONS and NEXT-FN arguments.
  7571.  
  7572. NEXT-FN is a function that searches forward from point for an annotation.
  7573. It should return a list of 4 elements: (BEGIN END NAME POSITIVE).  BEGIN and
  7574. END are buffer positions bounding the annotation, NAME is the name searched
  7575. for in TRANSLATIONS, and POSITIVE should be non-nil if this annotation marks
  7576. the beginning of a region with some property, or nil if it ends the region.
  7577. NEXT-FN should return nil if there are no annotations after point.
  7578.  
  7579. The basic format of the TRANSLATIONS argument is described in the
  7580. documentation for the `format-annotate-region' function.  There are some
  7581. additional things to keep in mind for decoding, though:
  7582.  
  7583. When an annotation is found, the TRANSLATIONS list is searched for a
  7584. text-property name and value that corresponds to that annotation.  If the
  7585. text-property has several annotations associated with it, it will be used only
  7586. if the other annotations are also in effect at that point.  The first match
  7587. found whose annotations are all present is used.
  7588.  
  7589. The text property thus determined is set to the value over the region between
  7590. the opening and closing annotations.  However, if the text-property name has a
  7591. non-nil `format-list-valued' property, then the value will be consed onto the
  7592. surrounding value of the property, rather than replacing that value.
  7593.  
  7594. There are some special symbols that can be used in the "property" slot of
  7595. the TRANSLATIONS list: PARAMETER and FUNCTION (spelled in uppercase).
  7596. Annotations listed under the pseudo-property PARAMETER are considered to be
  7597. arguments of the immediately surrounding annotation; the text between the
  7598. opening and closing parameter annotations is deleted from the buffer but saved
  7599. as a string.  The surrounding annotation should be listed under the
  7600. pseudo-property FUNCTION.  Instead of inserting a text-property for this
  7601. annotation, the function listed in the VALUE slot is called to make whatever
  7602. changes are appropriate.  The function's first two arguments are the START and
  7603. END locations, and the rest of the arguments are any PARAMETERs found in that
  7604. region.
  7605.  
  7606. Any annotations that are found by NEXT-FN but not defined by TRANSLATIONS
  7607. are saved as values of the `unknown' text-property (which is list-valued).
  7608. The TRANSLATIONS list should usually contain an entry of the form
  7609.     (unknown (nil format-annotate-value))
  7610. to write these unknown annotations back into the file.Fformat-insert-annotations
  7611. Apply list of annotations to buffer as `write-region' would.
  7612. Inserts each element of the given LIST of buffer annotations at its
  7613. appropriate place.  Use second arg OFFSET if the annotations' locations are
  7614. not relative to the beginning of the buffer: annotations will be inserted
  7615. at their location-OFFSET+1 (ie, the offset is treated as the character number
  7616. of the first character in the buffer).Fformat-annotate-value
  7617. Return OLD and NEW as a (close . open) annotation pair.
  7618. Useful as a default function for TRANSLATIONS alist when the value of the text
  7619. property is the name of the annotation that you want to use, as it is for the
  7620. `unknown' text property.Fformat-annotate-region
  7621. Generate annotations for text properties in the region.
  7622. Searches for changes between FROM and TO, and describes them with a list of
  7623. annotations as defined by alist TRANSLATIONS and FORMAT-FN.  IGNORE lists text
  7624. properties not to consider; any text properties that are neither ignored nor
  7625. listed in TRANSLATIONS are warned about.
  7626. If you actually want to modify the region, give the return value of this
  7627. function to `format-insert-annotations'.
  7628.  
  7629. Format of the TRANSLATIONS argument:
  7630.  
  7631. Each element is a list whose car is a PROPERTY, and the following
  7632. elements are VALUES of that property followed by the names of zero or more
  7633. ANNOTATIONS.  Whenever the property takes on that value, the annotations
  7634. (as formatted by FORMAT-FN) are inserted into the file.
  7635. When the property stops having that value, the matching negated annotation
  7636. will be inserted (it may actually be closed earlier and reopened, if
  7637. necessary, to keep proper nesting). 
  7638.  
  7639. If the property's value is a list, then each element of the list is dealt with
  7640. separately.
  7641.  
  7642. If a VALUE is numeric, then it is assumed that there is a single annotation
  7643. and each occurrence of it increments the value of the property by that number.
  7644. Thus, given the entry (left-margin (4 "indent")), if the left margin
  7645. changes from 4 to 12, two <indent> annotations will be generated.
  7646.  
  7647. If the VALUE is nil, then instead of annotations, a function should be
  7648. specified.  This function is used as a default: it is called for all
  7649. transitions not explicitly listed in the table.  The function is called with
  7650. two arguments, the OLD and NEW values of the property.  It should return
  7651. lists of annotations like `format-annotate-location' does.
  7652.  
  7653.     The same structure can be used in reverse for reading files.Fformat-annotate-location
  7654. Return annotation(s) needed at LOCATION.
  7655. This includes any properties that change between LOC-1 and LOC.
  7656. If ALL is true, don't look at previous location, but generate annotations for
  7657. all non-nil properties.
  7658. Third argument IGNORE is a list of text-properties not to consider.
  7659.  
  7660. Return value is a vector of 3 elements:
  7661. 1. List of names of the annotations to close
  7662. 2. List of the names of annotations to open.
  7663. 3. List of properties that were ignored or couldn't be annotated.Fformat-annotate-single-property-change
  7664. Return annotations for PROPERTY changing from OLD to NEW.
  7665. These are searched for in the TRANSLATIONS alist.
  7666. If NEW does not appear in the list, but there is a default function, then that
  7667. function is called.
  7668. Annotations to open and to close are returned as a dotted pair.Fformat-annotate-atomic-property-change
  7669. Internal function annotate a single property change.
  7670. PROP-ALIST is the relevant segment of a TRANSLATIONS list.
  7671. OLD and NEW are the values.Vhelp-map
  7672. Keymap for characters following the Help key.Vhelp-mode-map
  7673. Keymap for help mode.Ffinder-by-keyword
  7674. Find packages matching a given keyword.Vhelp-font-lock-keywords
  7675. Default expressions to highlight in Help mode.Fhelp-mode
  7676. Major mode for viewing help text.
  7677. Entry to this mode runs the normal hook `help-mode-hook'.
  7678. Commands:
  7679. \{help-mode-map}Fhelp-with-tutorial
  7680. Select the Emacs learn-by-doing tutorial.Fdescribe-key-briefly
  7681. Print the name of the function KEY invokes.  KEY is a string.Fprint-help-return-message
  7682. Display or return message saying how to restore windows after help command.
  7683. Computes a message and applies the optional argument FUNCTION to it.
  7684. If FUNCTION is nil, applies `message' to it, thus printing it.Fdescribe-key
  7685. Display documentation of the function invoked by KEY.  KEY is a string.Fdescribe-mode
  7686. Display documentation of current major mode and minor modes.
  7687. For this to work correctly for a minor mode, the mode's indicator variable
  7688. (listed in `minor-mode-alist') must also be a function whose documentation
  7689. describes the minor mode.Fdescribe-distribution
  7690. Display info on how to obtain the latest version of GNU Emacs.Fdescribe-copying
  7691. Display info on how you may redistribute copies of GNU Emacs.Fdescribe-project
  7692. Display info on the GNU project.Fdescribe-no-warranty
  7693. Display info on all the kinds of warranty Emacs does NOT have.Fdescribe-prefix-bindings
  7694. Describe the bindings of the prefix used to reach this command.
  7695. The prefix described consists of all but the last event
  7696. of the key sequence that ran this command.Fview-emacs-news
  7697. Display info on recent changes to Emacs.Fview-emacs-FAQ
  7698. Display the Emacs Frequently Asked Questions (FAQ) file.Fview-lossage
  7699. Display last 100 input keystrokes.Fhelp-for-help
  7700. You have typed \[help-command], the help character.  Type a Help option:
  7701. (Use SPC or DEL to scroll through this text.  Type \<help-map>\[help-quit] to exit the Help command.)
  7702.  
  7703. a  command-apropos.  Give a substring, and see a list of commands
  7704.     (functions interactively callable) that contain
  7705.     that substring.  See also the  apropos  command.
  7706. b  describe-bindings.  Display table of all key bindings.
  7707. c  describe-key-briefly.  Type a command key sequence;
  7708.     it prints the function name that sequence runs.
  7709. f  describe-function.  Type a function name and get documentation of it.
  7710. C-f Info-goto-emacs-command-node.  Type a function name;
  7711.     it takes you to the Info node for that command.
  7712. F  view-emacs-FAQ.  Shows emacs frequently asked questions file.
  7713. i  info. The  info  documentation reader.
  7714. k  describe-key.  Type a command key sequence;
  7715.     it displays the full documentation.
  7716. C-k Info-goto-emacs-key-command-node.  Type a command key sequence;
  7717.     it takes you to the Info node for the command bound to that key.
  7718. l  view-lossage.  Shows last 100 characters you typed.
  7719. m  describe-mode.  Print documentation of current major mode,
  7720.     which describes the commands peculiar to it.
  7721. n  view-emacs-news.  Shows emacs news file.
  7722. p  finder-by-keyword. Find packages matching a given topic keyword.
  7723. s  describe-syntax.  Display contents of syntax table, plus explanations
  7724. t  help-with-tutorial.  Select the Emacs learn-by-doing tutorial.
  7725. v  describe-variable.  Type name of a variable;
  7726.     it displays the variable's documentation and value.
  7727. w  where-is.  Type command name; it prints which keystrokes
  7728.     invoke that command.
  7729. C-c print Emacs copying permission (General Public License).
  7730. C-d print Emacs ordering information.
  7731. C-n print news of recent Emacs changes.
  7732. C-p print information about the GNU project.
  7733. C-w print information on absence of warranty for GNU Emacs.Fdescribe-function
  7734. Display the full documentation of FUNCTION (a symbol).Fdescribe-variable
  7735. Display the full documentation of VARIABLE (a symbol).
  7736. Returns the documentation as a string, also.Fwhere-is
  7737. Print message listing key sequences that invoke specified command.
  7738. Argument is a command definition, usually a symbol with a function definition.Flocate-library
  7739. Show the full path name of Emacs library LIBRARY.
  7740. This command searches the directories in `load-path' like `M-x load-library'
  7741. to find the file that `M-x load-library RET LIBRARY RET' would load.
  7742. Optional second arg NOSUFFIX non-nil means don't add suffixes `.elc' or `.el'
  7743. to the specified name LIBRARY (a la calling `load' instead of `load-library').Vstandard-indent
  7744. Default number of columns for margin-changing functions to indent.Vindent-line-function
  7745. Function to indent current line.Findent-according-to-mode
  7746. Indent line in proper way for current major mode.Findent-for-tab-command
  7747. Indent line in proper way for current major mode.Findent-rigidly
  7748. Indent all lines starting in the region sideways by ARG columns.
  7749. Called from a program, takes three arguments, START, END and ARG.Findent-line-to
  7750. Indent current line to COLUMN.
  7751. This function removes or adds spaces and tabs at beginning of line
  7752. only if necessary.  It leaves point at end of indentation.Fcurrent-left-margin
  7753. Return the left margin to use for this line.
  7754. This is the value of the buffer-local variable `left-margin' plus the value
  7755. of the `left-margin' text-property at the start of the line.Fmove-to-left-margin
  7756. Move to the left margin of the current line.
  7757. With optional argument, move forward N-1 lines first.
  7758. The column moved to is the one given by the `current-left-margin' function.
  7759. If the line's indentation appears to be wrong, and this command is called
  7760. interactively or with optional argument FORCE, it will be fixed.Findent-to-left-margin
  7761. Indent current line to the column given by `current-left-margin'.Fdelete-to-left-margin
  7762. Remove left margin indentation from a region.
  7763. This deletes to the column given by `current-left-margin'.
  7764. In no case will it delete non-whitespace.
  7765. Args FROM and TO are optional; default is the whole buffer.Fset-left-margin
  7766. Set the left margin of the region to WIDTH.
  7767. If `auto-fill-mode' is active, re-fill the region to fit the new margin.Fset-right-margin
  7768. Set the right margin of the region to WIDTH.
  7769. If `auto-fill-mode' is active, re-fill the region to fit the new margin.Falter-text-property
  7770. Programmatically change value of a text-property.
  7771. For each region between FROM and TO that has a single value for PROPERTY,
  7772. apply FUNCTION to that value and sets the property to the function's result.
  7773. Optional fifth argument OBJECT specifies the string or buffer to operate on.Fincrease-left-margin
  7774. Increase or decrease the left-margin of the region.
  7775. With no prefix argument, this adds `standard-indent' of indentation.
  7776. A prefix arg (optional third arg INC noninteractively) specifies the amount
  7777. to change the margin by, in characters.
  7778. If `auto-fill-mode' is active, re-fill the region to fit the new margin.Fdecrease-left-margin
  7779. Make the left margin of the region smaller.
  7780. With no prefix argument, decrease the indentation by `standard-indent'.
  7781. A prefix arg (optional third arg INC noninteractively) specifies the amount
  7782. to change the margin by, in characters.
  7783. If `auto-fill-mode' is active, re-fill the region to fit the new margin.Fincrease-right-margin
  7784. Increase the right-margin of the region.
  7785. With no prefix argument, increase the right margin by `standard-indent'.
  7786. A prefix arg (optional third arg INC noninteractively) specifies the amount
  7787. to change the margin by, in characters.  A negative argument decreases
  7788. the right margin width.
  7789. If `auto-fill-mode' is active, re-fill the region to fit the new margin.Fdecrease-right-margin
  7790. Make the right margin of the region smaller.
  7791. With no prefix argument, decrease the right margin by `standard-indent'.
  7792. A prefix arg (optional third arg INC noninteractively) specifies the amount
  7793. of width to remove, in characters.  A negative argument increases
  7794. the right margin width.
  7795. If `auto-fill-mode' is active, re-fills region to fit in new margin.Fbeginning-of-line-text
  7796. Move to the beginning of the text on this line.
  7797. With optional argument, move forward N-1 lines first.
  7798. From the beginning of the line, moves past the left-margin indentation, the
  7799. fill-prefix, and any indentation used for centering or right-justifying the
  7800. line, but does not move past any whitespace that was explicitly inserted 
  7801. (such as a tab used to indent the first line of a paragraph).Vindent-region-function
  7802. Short cut function to indent region using `indent-according-to-mode'.
  7803. A value of nil means really run `indent-according-to-mode' on each line.Findent-region
  7804. Indent each nonblank line in the region.
  7805. With no argument, indent each line using `indent-according-to-mode',
  7806. or use `indent-region-function' to do the whole region if that's non-nil.
  7807. If there is a fill prefix, make each line start with the fill prefix.
  7808. With argument COLUMN, indent each line to that column.
  7809. Called from a program, takes three args: START, END and COLUMN.Findent-relative-maybe
  7810. Indent a new line like previous nonblank line.Findent-relative
  7811. Space out to under next indent point in previous nonblank line.
  7812. An indent point is a non-whitespace character following whitespace.
  7813. If the previous nonblank line has no indent points beyond the
  7814. column point starts at, `tab-to-tab-stop' is done instead.Vtab-stop-list
  7815. *List of tab stop positions used by `tab-to-tab-stops'.
  7816. This should be a list of integers, ordered from smallest to largest.Vedit-tab-stops-map
  7817. Keymap used in `edit-tab-stops'.Vedit-tab-stops-buffer
  7818. Buffer whose tab stops are being edited--in case
  7819. the variable `tab-stop-list' is local in that buffer.Fedit-tab-stops
  7820. Edit the tab stops used by `tab-to-tab-stop'.
  7821. Creates a buffer *Tab Stops* containing text describing the tab stops.
  7822. A colon indicates a column where there is a tab stop.
  7823. You can add or remove colons and then do \<edit-tab-stops-map>\[edit-tab-stops-note-changes] to make changes take effect.Fedit-tab-stops-note-changes
  7824. Put edited tab stops into effect.Ftab-to-tab-stop
  7825. Insert spaces or tabs to next defined tab-stop column.
  7826. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  7827. Use \[edit-tab-stops] to edit them interactively.Fmove-to-tab-stop
  7828. Move point to next defined tab-stop column.
  7829. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  7830. Use \[edit-tab-stops] to edit them interactively.Vsearch-exit-option
  7831. *Non-nil means random control characters terminate incremental search.Vsearch-slow-window-lines
  7832. *Number of lines in slow search display windows.
  7833. These are the short windows used during incremental search on slow terminals.
  7834. Negative means put the slow search window at the top (normally it's at bottom)
  7835. and the value is minus the number of lines.Vsearch-slow-speed
  7836. *Highest terminal speed at which to use "slow" style incremental search.
  7837. This is the style where a one-line window is created to show the line
  7838. that the search has reached.Vsearch-upper-case
  7839. *If non-nil, upper case chars disable case fold searching.
  7840. That is, upper and lower case chars must match exactly.
  7841. This applies no matter where the chars come from, but does not
  7842. apply to chars in regexps that are prefixed with `\'.
  7843. If this value is `not-yanks', yanked text is always downcased.Vsearch-nonincremental-instead
  7844. *If non-nil, do a nonincremental search instead if exiting immediately.
  7845. Actually, `isearch-edit-string' is called to let you enter the search
  7846. string, and RET terminates editing and does a nonincremental search.Vsearch-whitespace-regexp
  7847. *If non-nil, regular expression to match a sequence of whitespace chars.
  7848. You might want to use something like "[ \t\r\n]+" instead.Vsearch-highlight
  7849. *Non-nil means incremental search highlights the current match.Visearch-mode-hook
  7850. Function(s) to call after starting up an incremental search.Visearch-mode-end-hook
  7851. Function(s) to call after terminating an incremental search.Vsearch-ring
  7852. List of search string sequences.Vregexp-search-ring
  7853. List of regular expression search string sequences.Vsearch-ring-max
  7854. *Maximum length of search ring before oldest elements are thrown away.Vregexp-search-ring-max
  7855. *Maximum length of regexp search ring before oldest elements are thrown away.Vsearch-ring-yank-pointer
  7856. Index in `search-ring' of last string reused.
  7857. nil if none yet.Vregexp-search-ring-yank-pointer
  7858. Index in `regexp-search-ring' of last string reused.
  7859. nil if none yet.Vsearch-ring-update
  7860. *Non-nil if advancing or retreating in the search ring should cause search.
  7861. Default value, nil, means edit the string instead.Visearch-mode-map
  7862. Keymap for isearch-mode.Vminibuffer-local-isearch-map
  7863. Keymap for editing isearch strings in the minibuffer.Fisearch-forward
  7864. Do incremental search forward.
  7865. With a prefix argument, do an incremental regular expression search instead.
  7866. \<isearch-mode-map>
  7867. As you type characters, they add to the search string and are found.
  7868. The following non-printing keys are bound in `isearch-mode-map'.  
  7869.  
  7870. Type \[isearch-delete-char] to cancel characters from end of search string.
  7871. Type \[isearch-exit] to exit, leaving point at location found.
  7872. Type LFD (C-j) to match end of line.
  7873. Type \[isearch-repeat-forward] to search again forward, \[isearch-repeat-backward] to search again backward.
  7874. Type \[isearch-yank-word] to yank word from buffer onto end of search string and search for it.
  7875. Type \[isearch-yank-line] to yank rest of line onto end of search string and search for it.
  7876. Type \[isearch-quote-char] to quote control character to search for it.
  7877. \[isearch-abort] while searching or when search has failed cancels input back to what has
  7878.  been found successfully.
  7879. \[isearch-abort] when search is successful aborts and moves point to starting point.
  7880.  
  7881. Also supported is a search ring of the previous 16 search strings.
  7882. Type \[isearch-ring-advance] to search for the next item in the search ring.
  7883. Type \[isearch-ring-retreat] to search for the previous item in the search ring.
  7884. Type \[isearch-complete] to complete the search string using the search ring.
  7885.  
  7886. The above keys, bound in `isearch-mode-map', are often controlled by 
  7887.  options; do M-x apropos on search-.* to find them.
  7888. Other control and meta characters terminate the search
  7889.  and are then executed normally (depending on `search-exit-option').
  7890. Likewise for function keys and mouse button events.
  7891.  
  7892. If this function is called non-interactively, it does not return to
  7893. the calling function until the search is done.Fisearch-forward-regexp
  7894. Do incremental search forward for regular expression.
  7895. With a prefix argument, do a regular string search instead.
  7896. Like ordinary incremental search except that your input
  7897. is treated as a regexp.  See \[isearch-forward] for more info.Fisearch-backward
  7898. Do incremental search backward.
  7899. With a prefix argument, do a regular expression search instead.
  7900. See \[isearch-forward] for more information.Fisearch-backward-regexp
  7901. Do incremental search backward for regular expression.
  7902. With a prefix argument, do a regular string search instead.
  7903. Like ordinary incremental search except that your input
  7904. is treated as a regexp.  See \[isearch-forward] for more info.Fisearch-mode
  7905. Start isearch minor mode.  Called by `isearch-forward', etc.
  7906.  
  7907. \{isearch-mode-map}Fisearch-update-ring
  7908. Add STRING to the beginning of the search ring.
  7909. REGEXP says which ring to use.Fisearch-exit
  7910. Exit search normally.
  7911. However, if this is the first command after starting incremental
  7912. search and `search-nonincremental-instead' is non-nil, do a
  7913. nonincremental search instead via `isearch-edit-string'.Fisearch-edit-string
  7914. Edit the search string in the minibuffer.
  7915. The following additional command keys are active while editing.
  7916. \<minibuffer-local-isearch-map>
  7917. \[exit-minibuffer] to resume incremental searching with the edited string.
  7918. \[isearch-nonincremental-exit-minibuffer] to do one nonincremental search.
  7919. \[isearch-forward-exit-minibuffer] to resume isearching forward.
  7920. \[isearch-reverse-exit-minibuffer] to resume isearching backward.
  7921. \[isearch-ring-advance-edit] to replace the search string with the next item in the search ring.
  7922. \[isearch-ring-retreat-edit] to replace the search string with the previous item in the search ring.
  7923. \[isearch-complete-edit] to complete the search string using the search ring.
  7924. \<isearch-mode-map>
  7925. If first char entered is \[isearch-yank-word], then do word search instead.Fisearch-cancel
  7926. Terminate the search and go back to the starting point.Fisearch-abort
  7927. Abort incremental search mode if searching is successful, signaling quit.
  7928. Otherwise, revert to previous successful search and continue searching.
  7929. Use `isearch-exit' to quit without signaling.Fisearch-repeat-forward
  7930. Repeat incremental search forwards.Fisearch-repeat-backward
  7931. Repeat incremental search backwards.Fisearch-toggle-regexp
  7932. Toggle regexp searching on or off.Fisearch-toggle-case-fold
  7933. Toggle case folding in searching on or off.Fisearch-delete-char
  7934. Discard last input item and move point back.  
  7935. If no previous match was done, just beep.Fisearch-yank-kill
  7936. Pull string from kill ring into search string.Fisearch-yank-word
  7937. Pull next word from buffer into search string.Fisearch-yank-line
  7938. Pull rest of line from buffer into search string.Fisearch-*-char
  7939. Handle * and ? specially in regexps.Fisearch-|-char
  7940. If in regexp search, jump to the barrier.Fisearch-other-meta-char
  7941. Exit the search normally and reread this key sequence.
  7942. But only if `search-exit-option' is non-nil, the default.
  7943. If it is the symbol `edit', the search string is edited in the minibuffer
  7944. and the meta character is unread so that it applies to editing the string.Fisearch-quote-char
  7945. Quote special characters for incremental search.Fisearch-return-char
  7946. Convert return into newline for incremental search.
  7947. Obsolete.Fisearch-printing-char
  7948. Add this ordinary printing character to the search string and search.Fisearch-whitespace-chars
  7949. Match all whitespace chars, if in regexp mode.
  7950. If you want to search for just a space, type C-q SPC.Fisearch-ring-advance
  7951. Advance to the next search string in the ring.Fisearch-ring-retreat
  7952. Retreat to the previous search string in the ring.Fisearch-ring-advance-edit
  7953. Insert the next element of the search history into the minibuffer.Fisearch-ring-retreat-edit
  7954. Inserts the previous element of the search history into the minibuffer.Fisearch-complete
  7955. Complete the search string from the strings on the search ring.
  7956. The completed string is then editable in the minibuffer.
  7957. If there is no completion possible, say so and continue searching.Fisearch-complete-edit
  7958. Same as `isearch-complete' except in the minibuffer.Fisearch-no-upper-case-p
  7959. Return t if there are no upper case chars in STRING.
  7960. If REGEXP-FLAG is non-nil, disregard letters preceded by `\' (but not `\\')
  7961. since they have special meaning in a regexp.Vlisp-mode-syntax-table
  7962. Vemacs-lisp-mode-syntax-table
  7963. Vlisp-mode-abbrev-table
  7964. Vlisp-imenu-generic-expression
  7965. Imenu generic expression for Lisp mode.  See `imenu-generic-expression'.Vshared-lisp-mode-map
  7966. Keymap for commands shared by all sorts of Lisp modes.Vemacs-lisp-mode-map
  7967. Keymap for Emacs Lisp mode.
  7968. All commands in `shared-lisp-mode-map' are inherited by this map.Femacs-lisp-byte-compile
  7969. Byte compile the file containing the current buffer.Femacs-lisp-byte-compile-and-load
  7970. Byte-compile the current file (if it has changed), then load compiled code.Femacs-lisp-mode
  7971. Major mode for editing Lisp code to run in Emacs.
  7972. Commands:
  7973. Delete converts tabs to spaces as it moves back.
  7974. Blank lines separate paragraphs.  Semicolons start comments.
  7975. \{emacs-lisp-mode-map}
  7976. Entry to this mode calls the value of `emacs-lisp-mode-hook'
  7977. if that value is non-nil.Vlisp-mode-map
  7978. Keymap for ordinary Lisp mode.
  7979. All commands in `shared-lisp-mode-map' are inherited by this map.Flisp-mode
  7980. Major mode for editing Lisp code for Lisps other than GNU Emacs Lisp.
  7981. Commands:
  7982. Delete converts tabs to spaces as it moves back.
  7983. Blank lines separate paragraphs.  Semicolons start comments.
  7984. \{lisp-mode-map}
  7985. Note that `run-lisp' may be used either to start an inferior Lisp job
  7986. or to switch back to an existing one.
  7987.  
  7988. Entry to this mode calls the value of `lisp-mode-hook'
  7989. if that value is non-nil.Flisp-eval-defun
  7990. Send the current defun to the Lisp process made by \[run-lisp].Vlisp-interaction-mode-map
  7991. Keymap for Lisp Interaction moe.
  7992. All commands in `shared-lisp-mode-map' are inherited by this map.Flisp-interaction-mode
  7993. Major mode for typing and evaluating Lisp forms.
  7994. Like Lisp mode except that \[eval-print-last-sexp] evals the Lisp expression
  7995. before point, and prints its value into the buffer, advancing point.
  7996.  
  7997. Commands:
  7998. Delete converts tabs to spaces as it moves back.
  7999. Paragraphs are separated only by blank lines.
  8000. Semicolons start comments.
  8001. \{lisp-interaction-mode-map}
  8002. Entry to this mode calls the value of `lisp-interaction-mode-hook'
  8003. if that value is non-nil.Feval-print-last-sexp
  8004. Evaluate sexp before point; print value into current buffer.Feval-last-sexp
  8005. Evaluate sexp before point; print value in minibuffer.
  8006. With argument, print output into current buffer.Feval-defun
  8007. Evaluate defun that point is in or before.
  8008. Print value in minibuffer.
  8009. With argument, insert value in current buffer after the defun.Vlisp-indent-offset
  8010. Vlisp-indent-function
  8011. Flisp-indent-line
  8012. Indent current line as Lisp code.
  8013. With argument, indent any additional lines of the same expression
  8014. rigidly along with this one.Fcalculate-lisp-indent
  8015. Return appropriate indentation for current line as Lisp code.
  8016. In usual case returns an integer: the column to indent to.
  8017. Can instead return a list, whose car is the column to indent to.
  8018. This means that following lines at the same level of indentation
  8019. should not necessarily be indented the same way.
  8020. The second element of the list is the buffer position
  8021. of the start of the containing expression.Vlisp-body-indent
  8022. Number of columns to indent the second line of a `(def...)' form.Findent-sexp
  8023. Indent each line of the list starting just after point.
  8024. If optional arg ENDPOS is given, indent each line, stopping when
  8025. ENDPOS is encountered.Flisp-fill-paragraph
  8026. Like \[fill-paragraph], but handle Emacs Lisp comments.
  8027. If any of the current line is a comment, fill the comment or the
  8028. paragraph of it that point is in, preserving the comment's indentation
  8029. and initial semicolons.Findent-code-rigidly
  8030. Indent all lines of code, starting in the region, sideways by ARG columns.
  8031. Does not affect lines starting inside comments or strings, assuming that
  8032. the start of the region is not inside them.
  8033.  
  8034. Called from a program, takes args START, END, COLUMNS and NOCHANGE-REGEXP.
  8035. The last is a regexp which, if matched at the beginning of a line,
  8036. means don't indent that line.Vdefun-prompt-regexp
  8037. *Non-nil => regexp to ignore, before the character that starts a defun.
  8038. This is only necessary if the opening paren or brace is not in column 0.
  8039. See `beginning-of-defun'.Vparens-require-spaces
  8040. Non-nil => `insert-parentheses' should insert whitespace as needed.Fforward-sexp
  8041. Move forward across one balanced expression (sexp).
  8042. With argument, do it that many times.  Negative arg -N means
  8043. move backward across N balanced expressions.Fbackward-sexp
  8044. Move backward across one balanced expression (sexp).
  8045. With argument, do it that many times.  Negative arg -N means
  8046. move forward across N balanced expressions.Fmark-sexp
  8047. Set mark ARG sexps from point.
  8048. The place mark goes is the same place \[forward-sexp] would
  8049. move to with the same argument.Fforward-list
  8050. Move forward across one balanced group of parentheses.
  8051. With argument, do it that many times.
  8052. Negative arg -N means move backward across N groups of parentheses.Fbackward-list
  8053. Move backward across one balanced group of parentheses.
  8054. With argument, do it that many times.
  8055. Negative arg -N means move forward across N groups of parentheses.Fdown-list
  8056. Move forward down one level of parentheses.
  8057. With argument, do this that many times.
  8058. A negative argument means move backward but still go down a level.
  8059. In Lisp programs, an argument is required.Fbackward-up-list
  8060. Move backward out of one level of parentheses.
  8061. With argument, do this that many times.
  8062. A negative argument means move forward but still to a less deep spot.
  8063. In Lisp programs, an argument is required.Fup-list
  8064. Move forward out of one level of parentheses.
  8065. With argument, do this that many times.
  8066. A negative argument means move backward but still to a less deep spot.
  8067. In Lisp programs, an argument is required.Fkill-sexp
  8068. Kill the sexp (balanced expression) following the cursor.
  8069. With argument, kill that many sexps after the cursor.
  8070. Negative arg -N means kill N sexps before the cursor.Fbackward-kill-sexp
  8071. Kill the sexp (balanced expression) preceding the cursor.
  8072. With argument, kill that many sexps before the cursor.
  8073. Negative arg -N means kill N sexps after the cursor.Fbeginning-of-defun
  8074. Move backward to the beginning of a defun.
  8075. With argument, do it that many times.  Negative arg -N
  8076. means move forward to Nth following beginning of defun.
  8077. Returns t unless search stops due to beginning or end of buffer.
  8078.  
  8079. Normally a defun starts when there is an char with open-parenthesis
  8080. syntax at the beginning of a line.  If `defun-prompt-regexp' is
  8081. non-nil, then a string which matches that regexp may precede the
  8082. open-parenthesis, and point ends up at the beginning of the line.Fbeginning-of-defun-raw
  8083. Move point to the character that starts a defun.
  8084. This is identical to beginning-of-defun, except that point does not move
  8085. to the beginning of the line when `defun-prompt-regexp' is non-nil.Fend-of-defun
  8086. Move forward to next end of defun.  With argument, do it that many times.
  8087. Negative argument -N means move back to Nth preceding end of defun.
  8088.  
  8089. An end of a defun occurs right after the close-parenthesis that matches
  8090. the open-parenthesis that starts a defun; see `beginning-of-defun'.Fmark-defun
  8091. Put mark at end of this defun, point at beginning.
  8092. The defun marked is the one that contains point or follows point.Finsert-parentheses
  8093. Put parentheses around next ARG sexps.  Leave point after open-paren.
  8094. No argument is equivalent to zero: just insert `()' and leave point between.
  8095. If `parens-require-spaces' is non-nil, this command also inserts a space
  8096. before and after, depending on the surrounding characters.Fmove-past-close-and-reindent
  8097. Move past next `)', delete indentation before it, then indent after it.Flisp-complete-symbol
  8098. Perform completion on Lisp symbol preceding point.
  8099. Compare that symbol against the known Lisp symbols.
  8100.  
  8101. The context determines which symbols are considered.
  8102. If the symbol starts just after an open-parenthesis, only symbols
  8103. with function definitions are considered.  Otherwise, all symbols with
  8104. function definitions, values or properties are considered.Vminor-mode-alist
  8105. Alist saying how to show minor modes in the mode line.
  8106. Each element looks like (VARIABLE STRING);
  8107. STRING is included in the mode line iff VARIABLE's value is non-nil.
  8108.  
  8109. Actually, STRING need not be a string; any possible mode-line element
  8110. is okay.  See `mode-line-format'.Fada-mode
  8111. Ada Mode is the major mode for editing Ada code.
  8112.  
  8113. Bindings are as follows: (Note: 'LFD' is control-j.)
  8114.  
  8115.  Indent line                                          '\[ada-tab]'
  8116.  Indent line, insert newline and indent the new line. '\[newline-and-indent]'
  8117.  
  8118.  Re-format the parameter-list point is in             '\[ada-format-paramlist]'
  8119.  Indent all lines in region                           '\[ada-indent-region]'
  8120.  Call external pretty printer program                 '\[ada-call-pretty-printer]'
  8121.  
  8122.  Adjust case of identifiers and keywords in region    '\[ada-adjust-case-region]'
  8123.  Adjust case of identifiers and keywords in buffer    '\[ada-adjust-case-buffer]'
  8124.  
  8125.  Call EXTERNAL pretty printer (if you have one)       '\[ada-call-pretty-printer]'
  8126.  
  8127.  Fill comment paragraph                               '\[ada-fill-comment-paragraph]'
  8128.  Fill comment paragraph and justify each line         '\[ada-fill-comment-paragraph-justify]'
  8129.  Fill comment paragraph, justify and append postfix   '\[ada-fill-comment-paragraph-postfix]'
  8130.  
  8131.  Next func/proc/task '\[ada-next-procedure]'    Previous func/proc/task '\[ada-previous-procedure]'
  8132.  Next package        '\[ada-next-package]'  Previous package        '\[ada-previous-package]'
  8133.  
  8134.  Goto matching start of current 'end ...;'            '\[ada-move-to-start]'
  8135.  Goto end of current block                            '\[ada-move-to-end]'
  8136.  
  8137. Comments are handled using standard GNU Emacs conventions, including:
  8138.  Start a comment                                      '\[indent-for-comment]'
  8139.  Comment region                                       '\[comment-region]'
  8140.  Uncomment region                                     '\[ada-uncomment-region]'
  8141.  Continue comment on next line                        '\[indent-new-comment-line]'
  8142.  
  8143. If you use imenu.el:
  8144.  Display index-menu of functions & procedures         '\[imenu]'
  8145.  
  8146. If you use find-file.el:
  8147.  Switch to other file (Body <-> Spec)                 '\[ff-find-other-file]'
  8148.                                                    or '\[ff-mouse-find-other-file]
  8149.  Switch to other file in other window                 '\[ada-ff-other-window]'
  8150.                                                    or '\[ff-mouse-find-other-file-other-window]
  8151.  If you use this function in a spec and no body is available, it gets created
  8152.  with body stubs.
  8153.  
  8154. If you use ada-xref.el:
  8155.  Goto declaration:          '\[ada-point-and-xref]' on the identifier
  8156.                          or '\[ada-goto-declaration]' with point on the identifier
  8157.  Complete identifier:       '\[ada-complete-identifier]'
  8158.  Execute Gnatf:             '\[ada-gnatf-current]'Fada-make-filename-from-adaname
  8159. Determine the filename of a package/procedure from its own Ada name.Vadd-log-full-name
  8160. *Full name of user, for inclusion in ChangeLog daily headers.
  8161. This defaults to the value returned by the `user-full-name' function.Vadd-log-mailing-address
  8162. *Electronic mail address of user, for inclusion in ChangeLog daily headers.
  8163. This defaults to the value of `user-mail-address'.Fprompt-for-change-log-name
  8164. Prompt for a change log name.Ffind-change-log
  8165. Find a change log file for \[add-change-log-entry] and return the name.
  8166.  
  8167. Optional arg FILE-NAME specifies the file to use.
  8168. If FILE-NAME is nil, use the value of `change-log-default-name'.
  8169. If 'change-log-default-name' is nil, behave as though it were 'ChangeLog'
  8170. (or whatever we use on this operating system).
  8171.  
  8172. If 'change-log-default-name' contains a leading directory component, then
  8173. simply find it in the current directory.  Otherwise, search in the current 
  8174. directory and its successive parents for a file so named.
  8175.  
  8176. Once a file is found, `change-log-default-name' is set locally in the
  8177. current buffer to the complete file name.Fadd-change-log-entry
  8178. Find change log file and add an entry for today.
  8179. Optional arg (interactive prefix) non-nil means prompt for user name and site.
  8180. Second arg is file name of change log.  If nil, uses `change-log-default-name'.
  8181. Third arg OTHER-WINDOW non-nil means visit in other window.
  8182. Fourth arg NEW-ENTRY non-nil means always create a new entry at the front;
  8183. never append to an existing entry.Fadd-change-log-entry-other-window
  8184. Find change log file in other window and add an entry for today.
  8185. Optional arg (interactive prefix) non-nil means prompt for user name and site.
  8186. Second arg is file name of change log.  If nil, uses `change-log-default-name'.Fchange-log-mode
  8187. Major mode for editing change logs; like Indented Text Mode.
  8188. Prevents numeric backups and sets `left-margin' to 8 and `fill-column' to 74.
  8189. New log entries are usually made with \[add-change-log-entry] or \[add-change-log-entry-other-window].
  8190. Each entry behaves as a paragraph, and the entries for one day as a page.
  8191. Runs `change-log-mode-hook'.Fadd-log-current-defun
  8192. Return name of function definition point is in, or nil.
  8193.  
  8194. Understands C, Lisp, LaTeX ("functions" are chapters, sections, ...),
  8195. Texinfo (@node titles), Perl, and Fortran.
  8196.  
  8197. Other modes are handled by a heuristic that looks in the 10K before
  8198. point for uppercase headings starting in the first column or
  8199. identifiers followed by `:' or `=', see variable
  8200. `add-log-current-defun-header-regexp'.
  8201.  
  8202. Has a preference of looking backwards.Vad-redefinition-action
  8203. *Defines what to do with redefinitions during Advice de/activation.
  8204. Redefinition occurs if a previously activated function that already has an
  8205. original definition associated with it gets redefined and then de/activated.
  8206. In such a case we can either accept the current definition as the new
  8207. original definition, discard the current definition and replace it with the
  8208. old original, or keep it and raise an error.  The values `accept', `discard',
  8209. `error' or `warn' govern what will be done.  `warn' is just like `accept' but
  8210. it additionally prints a warning message.  All other values will be
  8211. interpreted as `error'.Vad-default-compilation-action
  8212. *Defines whether to compile advised definitions during activation.
  8213. A value of `always' will result in unconditional compilation, `never' will
  8214. always avoid compilation, `maybe' will compile if the byte-compiler is already
  8215. loaded, and `like-original' will compile if the original definition of the
  8216. advised function is compiled or a built-in function. Every other value will
  8217. be interpreted as `maybe'. This variable will only be considered if the
  8218. COMPILE argument of `ad-activate' was supplied as nil.Fad-add-advice
  8219. Adds a piece of ADVICE to FUNCTION's list of advices in CLASS.
  8220. If FUNCTION already has one or more pieces of advice of the specified
  8221. CLASS then POSITION determines where the new piece will go.  The value
  8222. of POSITION can either be `first', `last' or a number where 0 corresponds
  8223. to `first'.  Numbers outside the range will be mapped to the closest
  8224. extreme position.  If there was already a piece of ADVICE with the same
  8225. name, then the position argument will be ignored and the old advice
  8226. will be overwritten with the new one.
  8227.     If the FUNCTION was not advised already, then its advice info will be
  8228. initialized.  Redefining a piece of advice whose name is part of the cache-id
  8229. will clear the cache.Fdefadvice
  8230. Defines a piece of advice for FUNCTION (a symbol).
  8231. The syntax of `defadvice' is as follows:
  8232.  
  8233.   (defadvice FUNCTION (CLASS NAME [POSITION] [ARGLIST] FLAG...)
  8234.     [DOCSTRING] [INTERACTIVE-FORM]
  8235.     BODY... )
  8236.  
  8237. FUNCTION ::= Name of the function to be advised.
  8238. CLASS ::= `before' | `around' | `after' | `activation' | `deactivation'.
  8239. NAME ::= Non-nil symbol that names this piece of advice.
  8240. POSITION ::= `first' | `last' | NUMBER. Optional, defaults to `first',
  8241.     see also `ad-add-advice'.
  8242. ARGLIST ::= An optional argument list to be used for the advised function
  8243.     instead of the argument list of the original.  The first one found in
  8244.     before/around/after-advices will be used.
  8245. FLAG ::= `protect'|`disable'|`activate'|`compile'|`preactivate'|`freeze'.
  8246.     All flags can be specified with unambiguous initial substrings.
  8247. DOCSTRING ::= Optional documentation for this piece of advice.
  8248. INTERACTIVE-FORM ::= Optional interactive form to be used for the advised
  8249.     function.  The first one found in before/around/after-advices will be used.
  8250. BODY ::= Any s-expression.
  8251.  
  8252. Semantics of the various flags:
  8253. `protect': The piece of advice will be protected against non-local exits in
  8254. any code that precedes it.  If any around-advice of a function is protected
  8255. then automatically all around-advices will be protected (the complete onion).
  8256.  
  8257. `activate': All advice of FUNCTION will be activated immediately if
  8258. FUNCTION has been properly defined prior to this application of `defadvice'.
  8259.  
  8260. `compile': In conjunction with `activate' specifies that the resulting
  8261. advised function should be compiled.
  8262.  
  8263. `disable': The defined advice will be disabled, hence, it will not be used
  8264. during activation until somebody enables it.
  8265.  
  8266. `preactivate': Preactivates the advised FUNCTION at macro-expansion/compile
  8267. time.  This generates a compiled advised definition according to the current
  8268. advice state that will be used during activation if appropriate.  Only use
  8269. this if the `defadvice' gets actually compiled.
  8270.  
  8271. `freeze': Expands the `defadvice' into a redefining `defun/defmacro' according
  8272. to this particular single advice.  No other advice information will be saved.
  8273. Frozen advices cannot be undone, they behave like a hard redefinition of
  8274. the advised function.  `freeze' implies `activate' and `preactivate'.  The
  8275. documentation of the advised function can be dumped onto the `DOC' file
  8276. during preloading.
  8277.  
  8278. Look at the file `advice.el' for comprehensive documentation.Vappt-issue-message
  8279. *Non-nil means check for appointments in the diary buffer.
  8280. To be detected, the diary entry must have the time
  8281. as the first thing on a line.Vappt-message-warning-time
  8282. *Time in minutes before an appointment that the warning begins.Vappt-audible
  8283. *Non-nil means beep to indicate appointment.Vappt-visible
  8284. *Non-nil means display appointment message in echo area.Vappt-display-mode-line
  8285. *Non-nil means display minutes to appointment and time on the mode line.Vappt-msg-window
  8286. *Non-nil means display appointment message in another window.Vappt-display-duration
  8287. *The number of seconds an appointment message is displayed.Vappt-display-diary
  8288. *Non-nil means to display the next days diary on the screen. 
  8289. This will occur at midnight when the appointment list is updated.Fapropos-command
  8290. Shows commands (interactively callable functions) that match REGEXP.
  8291. With optional prefix ARG or if `apropos-do-all' is non-nil, also show
  8292. variables.Fapropos
  8293. Show all bound symbols whose names match REGEXP.
  8294. With optional prefix ARG or if `apropos-do-all' is non-nil, also show unbound
  8295. symbols and key bindings, which is a little more time-consuming.
  8296. Returns list of symbols and documentation found.Fapropos-value
  8297. Show all symbols whose value's printed image matches REGEXP.
  8298. With optional prefix ARG or if `apropos-do-all' is non-nil, also looks
  8299. at the function and at the names and values of properties.
  8300. Returns list of symbols and values found.Fapropos-documentation
  8301. Show symbols whose documentation contain matches for REGEXP.
  8302. With optional prefix ARG or if `apropos-do-all' is non-nil, also use
  8303. documentation that is not stored in the documentation file and show key
  8304. bindings.
  8305. Returns list of symbols and documentation found.Farchive-mode
  8306. Major mode for viewing an archive file in a dired-like way.
  8307. You can move around using the usual cursor motion commands.
  8308. Letters no longer insert themselves.
  8309. Type `e' to pull a file out of the archive and into its own buffer;
  8310. or click mouse-2 on the file's line in the archive mode buffer.
  8311.  
  8312. If you edit a sub-file of this archive (as with the `e' command) and
  8313. save it, the contents of that buffer will be saved back into the
  8314. archive.
  8315.  
  8316. \{archive-mode-map}Fasm-mode
  8317. Major mode for editing typical assembler code.
  8318. Features a private abbrev table and the following bindings:
  8319.  
  8320. \[asm-colon]    outdent a preceding label, tab to next tab stop.
  8321. \[tab-to-tab-stop]    tab to next tab stop.
  8322. \[asm-newline]    newline, then tab to next tab stop.
  8323. \[asm-comment]    smart placement of assembler comments.
  8324.  
  8325. The character used for making comments is set by the variable
  8326. `asm-comment-char' (which defaults to `?;').
  8327.  
  8328. Alternatively, you may set this variable in `asm-mode-set-comment-hook',
  8329. which is called near the beginning of mode initialization.
  8330.  
  8331. Turning on Asm mode runs the hook `asm-mode-hook' at the end of initialization.
  8332.  
  8333. Special commands:
  8334. \{asm-mode-map}
  8335. Fauto-show-mode
  8336. Turn automatic horizontal scroll mode on or off.
  8337. With arg, turn auto scrolling on if arg is positive, off otherwise.Fauto-insert
  8338. Insert default contents into a new file if `auto-insert' is non-nil.
  8339. Matches the visited file name against the elements of `auto-insert-alist'.Fdefine-auto-insert
  8340. Associate CONDITION with (additional) ACTION in `auto-insert-alist'.
  8341. Optional AFTER means to insert action after all existing actions for CONDITION,
  8342. or if CONDITION had no actions, after all other CONDITIONs.Fupdate-file-autoloads
  8343. Update the autoloads for FILE in `generated-autoload-file'
  8344. (which FILE might bind in its local variables).Fupdate-autoloads-from-directory
  8345. Update loaddefs.el with all the current autoloads from DIR, and no old ones.
  8346. This uses `update-file-autoloads' (which see) do its work.Fbatch-update-autoloads
  8347. Update loaddefs.el autoloads in batch mode.
  8348. Calls `update-autoloads-from-directory' on each command line argument.Fmouse-avoidance-mode
  8349. Set cursor avoidance mode to MODE.
  8350. MODE should be one of the symbols `banish', `exile', `jump', `animate',
  8351. `cat-and-mouse', `proteus', or `none'.
  8352.  
  8353. If MODE is nil, toggle mouse avoidance between `none` and `banish'
  8354. modes.  Positive numbers and symbols other than the above are treated
  8355. as equivalent to `banish'; negative numbers and `-' are equivalent to `none'.
  8356.  
  8357. Effects of the different modes: 
  8358.  * banish: Move the mouse to the upper-right corner on any keypress.
  8359.  * exile: Move the mouse to the corner only if the cursor gets too close,
  8360.      and allow it to return once the cursor is out of the way.
  8361.  * jump: If the cursor gets too close to the mouse, displace the mouse
  8362.      a random distance & direction.
  8363.  * animate: As `jump', but shows steps along the way for illusion of motion.
  8364.  * cat-and-mouse: Same as `animate'.
  8365.  * proteus: As `animate', but changes the shape of the mouse pointer too.
  8366.  
  8367. Whenever the mouse is moved, the frame is also raised.
  8368.  
  8369. (see `mouse-avoidance-threshold' for definition of "too close",
  8370. and `mouse-avoidance-nudge-dist' and `mouse-avoidance-nudge-var' for
  8371. definition of "random distance".)Fawk-mode
  8372. Major mode for editing AWK code.
  8373. This is much like C mode except for the syntax of comments.  It uses
  8374. the same keymap as C mode and has the same variables for customizing
  8375. indentation.  It has its own abbrev table and its own syntax table.
  8376.  
  8377. Turning on AWK mode calls the value of the variable `awk-mode-hook'
  8378. with no args, if that value is non-nil.Fbackquote
  8379. Argument STRUCTURE describes a template to build.
  8380.  
  8381. The whole structure acts as if it were quoted except for certain
  8382. places where expressions are evaluated and inserted or spliced in.
  8383.  
  8384. For example:
  8385.  
  8386. b              => (ba bb bc)        ; assume b has this value
  8387. `(a b c)       => (a b c)        ; backquote acts like quote
  8388. `(a ,b c)      => (a (ba bb bc) c)    ; insert the value of b
  8389. `(a ,@b c)     => (a ba bb bc c)    ; splice in the value of b
  8390.  
  8391. Vectors work just like lists.  Nested backquotes are permitted.Fbibtex-mode
  8392. Major mode for editing BibTeX files.
  8393. To submit a problem report, enter `\[bibtex-submit-bug-report]' from a
  8394. bibtex-mode buffer.  This automatically sets up a mail buffer with
  8395. version information already added.  You just need to add a description
  8396. of the problem, including a reproducable test case and send the
  8397. message.
  8398.  
  8399. \{bibtex-mode-map}
  8400.  
  8401. A command such as \[bibtex-Book] will outline the fields for a BibTeX book entry.
  8402.  
  8403. The optional fields start with the string OPT, and thus ignored by BibTeX.
  8404. The OPT string may be removed from a field with \[bibtex-remove-OPT].
  8405. \[bibtex-kill-optional-field] kills the current optional field entirely.
  8406. \[bibtex-remove-double-quotes-or-braces] removes the double-quotes or
  8407. braces around the text of the current field.  \[bibtex-empty-field]
  8408. replaces the text of the current field with the default "" or {}.
  8409.  
  8410. The command \[bibtex-clean-entry] cleans the current entry, i.e. (i) removes
  8411. double-quotes or braces from entirely numerical fields, (ii) removes
  8412. OPT from all non-empty optional fields, (iii) removes all empty
  8413. optional fields, and (iv) checks that no non-optional fields are empty.
  8414.  
  8415. Use \[bibtex-find-text] to position the cursor at the end of the current field.
  8416. Use \[bibtex-next-field] to move to end of the next field.
  8417.  
  8418. The following may be of interest as well:
  8419.  
  8420.   Functions:
  8421.     bibtex-entry
  8422.     bibtex-print-help-message
  8423.     bibtex-beginning-of-entry
  8424.     bibtex-end-of-entry
  8425.     bibtex-ispell-abstract
  8426.     bibtex-narrow-to-entry
  8427.     bibtex-hide-entry-bodies
  8428.     bibtex-sort-entries
  8429.     bibtex-validate-buffer
  8430.     bibtex-pop-previous
  8431.     bibtex-pop-next
  8432.     bibtex-complete-string
  8433.  
  8434.   Variables:
  8435.     bibtex-field-left-delimiter
  8436.     bibtex-field-right-delimiter
  8437.     bibtex-include-OPTcrossref
  8438.     bibtex-include-OPTkey
  8439.     bibtex-include-OPTannote
  8440.     bibtex-mode-user-optional-fields
  8441.     bibtex-clean-entry-zap-empty-opts
  8442.     bibtex-sort-ignore-string-entries
  8443.     bibtex-maintain-sorted-entries
  8444.     bibtex-entry-field-alist
  8445.     bibtex-predefined-strings
  8446.     bibtex-string-files
  8447.  
  8448. ---------------------------------------------------------
  8449. Entry to this mode calls the value of bibtex-mode-hook if that value is
  8450. non-nil.Fblackbox
  8451. Play blackbox.  Optional prefix argument is the number of balls;
  8452. the default is 4.
  8453.  
  8454. What is blackbox?
  8455.  
  8456. Blackbox is a game of hide and seek played on an 8 by 8 grid (the
  8457. Blackbox).  Your opponent (Emacs, in this case) has hidden several
  8458. balls (usually 4) within this box.  By shooting rays into the box and
  8459. observing where they emerge it is possible to deduce the positions of
  8460. the hidden balls.  The fewer rays you use to find the balls, the lower
  8461. your score.
  8462.  
  8463. Overview of play:
  8464.  
  8465. \<blackbox-mode-map>To play blackbox, type \[blackbox].  An optional prefix argument
  8466. specifies the number of balls to be hidden in the box; the default is
  8467. four.
  8468.  
  8469. The cursor can be moved around the box with the standard cursor
  8470. movement keys.
  8471.  
  8472. To shoot a ray, move the cursor to the edge of the box and press SPC.
  8473. The result will be determined and the playfield updated.
  8474.  
  8475. You may place or remove balls in the box by moving the cursor into the
  8476. box and pressing \[bb-romp].
  8477.  
  8478. When you think the configuration of balls you have placed is correct,
  8479. press \[bb-done].  You will be informed whether you are correct or
  8480. not, and be given your score.  Your score is the number of letters and
  8481. numbers around the outside of the box plus five for each incorrectly
  8482. placed ball.  If you placed any balls incorrectly, they will be
  8483. indicated with `x', and their actual positions indicated with `o'.
  8484.  
  8485. Details:
  8486.  
  8487. There are three possible outcomes for each ray you send into the box:
  8488.  
  8489.     Detour: the ray is deflected and emerges somewhere other than
  8490.         where you sent it in.  On the playfield, detours are
  8491.         denoted by matching pairs of numbers -- one where the
  8492.         ray went in, and the other where it came out.
  8493.  
  8494.     Reflection: the ray is reflected and emerges in the same place
  8495.         it was sent in.  On the playfield, reflections are
  8496.         denoted by the letter `R'.
  8497.  
  8498.     Hit:    the ray strikes a ball directly and is absorbed.  It does
  8499.         not emerge from the box.  On the playfield, hits are
  8500.         denoted by the letter `H'.
  8501.  
  8502. The rules for how balls deflect rays are simple and are best shown by
  8503. example.
  8504.  
  8505. As a ray approaches a ball it is deflected ninety degrees.  Rays can
  8506. be deflected multiple times.  In the diagrams below, the dashes
  8507. represent empty box locations and the letter `O' represents a ball.
  8508. The entrance and exit points of each ray are marked with numbers as
  8509. described under "Detour" above.  Note that the entrance and exit
  8510. points are always interchangeable.  `*' denotes the path taken by the
  8511. ray.
  8512.  
  8513. Note carefully the relative positions of the ball and the ninety
  8514. degree deflection it causes.
  8515.  
  8516.     1
  8517.   - * - - - - - -         - - - - - - - -         - - - - - - - -
  8518.   - * - - - - - -         - - - - - - - -         - - - - - - - -
  8519. 1 * * - - - - - -         - - - - - - - -         - O - - - - O -
  8520.   - - O - - - - -         - - O - - - - -         - - * * * * - -
  8521.   - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
  8522.   - - - - - - - -         - - - * - - - -         - - - O - * - -
  8523.   - - - - - - - -         - - - * - - - -         - - - - * * - -
  8524.   - - - - - - - -         - - - * - - - -         - - - - * - O -
  8525.                                 2                         3
  8526.  
  8527. As mentioned above, a reflection occurs when a ray emerges from the same point
  8528. it was sent in.  This can happen in several ways:
  8529.  
  8530.  
  8531.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  8532.   - - - - O - - -         - - O - O - - -          - - - - - - - -
  8533. R * * * * - - - -         - - - * - - - -          O - - - - - - -
  8534.   - - - - O - - -         - - - * - - - -        R - - - - - - - -
  8535.   - - - - - - - -         - - - * - - - -          - - - - - - - -
  8536.   - - - - - - - -         - - - * - - - -          - - - - - - - -
  8537.   - - - - - - - -       R * * * * - - - -          - - - - - - - -
  8538.   - - - - - - - -         - - - - O - - -          - - - - - - - -
  8539.  
  8540. In the first example, the ray is deflected downwards by the upper
  8541. ball, then left by the lower ball, and finally retraces its path to
  8542. its point of origin.  The second example is similar.  The third
  8543. example is a bit anomalous but can be rationalized by realizing the
  8544. ray never gets a chance to get into the box.  Alternatively, the ray
  8545. can be thought of as being deflected downwards and immediately
  8546. emerging from the box.
  8547.  
  8548. A hit occurs when a ray runs straight into a ball:
  8549.  
  8550.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  8551.   - - - - - - - -         - - - - - - - -          - - - - O - - -
  8552.   - - - - - - - -         - - - - O - - -        H * * * * - - - -
  8553.   - - - - - - - -       H * * * * O - - -          - - - * - - - -
  8554.   - - - - - - - -         - - - - O - - -          - - - O - - - -
  8555. H * * * O - - - -         - - - - - - - -          - - - - - - - -
  8556.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  8557.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  8558.  
  8559. Be sure to compare the second example of a hit with the first example of
  8560. a reflection.Vbookmark-map
  8561. Keymap containing bindings to bookmark functions.
  8562. It is not bound to any key by default: to bind it
  8563. so that you have a bookmark prefix, just use `global-set-key' and bind a
  8564. key of your choice to `bookmark-map'.  All interactive bookmark
  8565. functions have a binding in this keymap.Fbookmark-set
  8566. Set a bookmark named NAME inside a file.
  8567. If name is nil, then the user will be prompted.
  8568. With prefix arg, will not overwrite a bookmark that has the same name
  8569. as NAME if such a bookmark already exists, but instead will "push"
  8570. the new bookmark onto the bookmark alist.  Thus the most recently set
  8571. bookmark with name NAME would be the one in effect at any given time,
  8572. but the others are still there, should you decide to delete the most
  8573. recent one.
  8574.  
  8575. To yank words from the text of the buffer and use them as part of the
  8576. bookmark name, type C-w while setting a bookmark.  Successive C-w's
  8577. yank successive words.
  8578.  
  8579. Typing C-u inserts the name of the last bookmark used in the buffer
  8580. (as an aid in using a single bookmark name to track your progress
  8581. through a large file).  If no bookmark was used, then C-u inserts the
  8582. name of the file being visited.
  8583.  
  8584. Use \[bookmark-delete] to remove bookmarks (you give it a name,
  8585. and it removes only the first instance of a bookmark with that name from
  8586. the list of bookmarks.)Fbookmark-jump
  8587. Jump to bookmark BOOKMARK (a point in some file).  
  8588. You may have a problem using this function if the value of variable
  8589. `bookmark-alist' is nil.  If that happens, you need to load in some
  8590. bookmarks.  See help on function `bookmark-load' for more about
  8591. this.
  8592.  
  8593. If the file pointed to by BOOKMARK no longer exists, you will be asked
  8594. if you wish to give the bookmark a new location, and bookmark-jump
  8595. will then jump to the new location, as well as recording it in place
  8596. of the old one in the permanent bookmark record.Fbookmark-relocate
  8597. Relocate BOOKMARK to another file (reading file name with minibuffer).
  8598. This makes an already existing bookmark point to that file, instead of
  8599. the one it used to point at.  Useful when a file has been renamed
  8600. after a bookmark was set in it.Fbookmark-insert-location
  8601. Insert the name of the file associated with BOOKMARK.
  8602. Optional second arg NO-HISTORY means don't record this in the
  8603. minibuffer history list `bookmark-history'.Fbookmark-rename
  8604. Change the name of OLD bookmark to NEW name.
  8605. If called from keyboard, prompt for OLD and NEW.  If called from
  8606. menubar, select OLD from a menu and prompt for NEW.
  8607.  
  8608. If called from Lisp, prompt for NEW if only OLD was passed as an
  8609. argument.  If called with two strings, then no prompting is done.  You
  8610. must pass at least OLD when calling from Lisp.
  8611.  
  8612. While you are entering the new name, consecutive C-w's insert
  8613. consecutive words from the text of the buffer into the new bookmark
  8614. name.Fbookmark-insert
  8615. Insert the text of the file pointed to by bookmark BOOKMARK.  
  8616. You may have a problem using this function if the value of variable
  8617. `bookmark-alist' is nil.  If that happens, you need to load in some
  8618. bookmarks.  See help on function `bookmark-load' for more about
  8619. this.Fbookmark-delete
  8620. Delete BOOKMARK from the bookmark list.  
  8621. Removes only the first instance of a bookmark with that name.  If
  8622. there are one or more other bookmarks with the same name, they will
  8623. not be deleted.  Defaults to the "current" bookmark (that is, the
  8624. one most recently used in this file, if any).
  8625. Optional second arg BATCH means don't update the bookmark list buffer,
  8626. probably because we were called from there.Fbookmark-write
  8627. Write bookmarks to a file (reading the file name with the minibuffer).
  8628. Don't use this in Lisp programs; use `bookmark-save' instead.Fbookmark-save
  8629. Save currently defined bookmarks.
  8630. Saves by default in the file defined by the variable
  8631. `bookmark-default-file'.  With a prefix arg, save it in file FILE
  8632. (second argument).
  8633.  
  8634. If you are calling this from Lisp, the two arguments are PREFIX-ARG
  8635. and FILE, and if you just want it to write to the default file, then
  8636. pass no arguments.  Or pass in nil and FILE, and it will save in FILE
  8637. instead.  If you pass in one argument, and it is non-nil, then the
  8638. user will be interactively queried for a file to save in.
  8639.  
  8640. When you want to load in the bookmarks from a file, use
  8641. `bookmark-load', \[bookmark-load].  That function will prompt you
  8642. for a file, defaulting to the file defined by variable
  8643. `bookmark-default-file'.Fbookmark-load
  8644. Load bookmarks from FILE (which must be in bookmark format).
  8645. Appends loaded bookmarks to the front of the list of bookmarks.  If
  8646. optional second argument REVERT is non-nil, existing bookmarks are
  8647. destroyed.  Optional third arg NO-MSG means don't display any messages
  8648. while loading.
  8649.  
  8650. If you load a file that doesn't contain a proper bookmark alist, you
  8651. will corrupt Emacs's bookmark list.  Generally, you should only load
  8652. in files that were created with the bookmark functions in the first
  8653. place.  Your own personal bookmark file, `~/.emacs.bmk', is
  8654. maintained automatically by Emacs; you shouldn't need to load it
  8655. explicitly.Fbookmark-bmenu-list
  8656. Display a list of existing bookmarks.
  8657. The list is displayed in a buffer named `*Bookmark List*'.
  8658. The leftmost column displays a D if the bookmark is flagged for
  8659. deletion, or > if it is flagged for displaying.Fbookmark-menu-insert
  8660. Insert the text of the file pointed to by bookmark BOOKMARK.  
  8661. You may have a problem using this function if the value of variable
  8662. `bookmark-alist' is nil.  If that happens, you need to load in some
  8663. bookmarks.  See help on function `bookmark-load' for more about
  8664. this.
  8665.  
  8666. Warning: this function only takes an EVENT as argument.  Use the
  8667. corresponding bookmark function from Lisp (the one without the
  8668. "-menu-" in its name).Fbookmark-menu-jump
  8669. Jump to bookmark BOOKMARK (a point in some file).  
  8670. You may have a problem using this function if the value of variable
  8671. `bookmark-alist' is nil.  If that happens, you need to load in some
  8672. bookmarks.  See help on function `bookmark-load' for more about
  8673. this.
  8674.  
  8675. Warning: this function only takes an EVENT as argument.  Use the
  8676. corresponding bookmark function from Lisp (the one without the
  8677. "-menu-" in its name).Fbookmark-menu-locate
  8678. Insert the name of the file associated with BOOKMARK. 
  8679. (This is not the same as the contents of that file).
  8680.  
  8681. Warning: this function only takes an EVENT as argument.  Use the
  8682. corresponding bookmark function from Lisp (the one without the
  8683. "-menu-" in its name).Fbookmark-menu-rename
  8684. Change the name of OLD-BOOKMARK to NEWNAME.  
  8685. If called from keyboard, prompts for OLD-BOOKMARK and NEWNAME.
  8686. If called from menubar, OLD-BOOKMARK is selected from a menu, and
  8687. prompts for NEWNAME. 
  8688. If called from Lisp, prompts for NEWNAME if only OLD-BOOKMARK was
  8689. passed as an argument.  If called with two strings, then no prompting
  8690. is done.  You must pass at least OLD-BOOKMARK when calling from Lisp.
  8691.  
  8692. While you are entering the new name, consecutive C-w's insert
  8693. consecutive words from the text of the buffer into the new bookmark
  8694. name.
  8695.  
  8696. Warning: this function only takes an EVENT as argument.  Use the
  8697. corresponding bookmark function from Lisp (the one without the
  8698. "-menu-" in its name).Fbookmark-menu-delete
  8699. Delete the bookmark named NAME from the bookmark list.  
  8700. Removes only the first instance of a bookmark with that name.  If
  8701. there are one or more other bookmarks with the same name, they will
  8702. not be deleted.  Defaults to the "current" bookmark (that is, the
  8703. one most recently used in this file, if any).
  8704.  
  8705. Warning: this function only takes an EVENT as argument.  Use the
  8706. corresponding bookmark function from Lisp (the one without the
  8707. "-menu-" in its name).Fbrowse-url-at-point
  8708. Ask a WWW browser to load the URL at or before point.
  8709. The URL is loaded according to the value of `browse-url-browser-function'.Fbrowse-url-at-mouse
  8710. Ask a WWW browser to load a URL clicked with the mouse.
  8711. The URL is the one around or before the position of the mouse click
  8712. but point is not changed.  The URL is loaded according to the value of
  8713. `browse-url-browser-function'.Fbrowse-url-of-file
  8714. Ask a WWW browser to display FILE.
  8715. Display the current buffer's file if FILE is nil or if called
  8716. interactively.  Turn the filename into a URL by performing
  8717. replacements given in variable `browse-url-filename-alist'.  Pass the
  8718. URL to a browser using variable `browse-url-browser-function' then run
  8719. `browse-url-of-file-hook'.Fbrowse-url-of-buffer
  8720. Ask a WWW browser to display BUFFER.
  8721. Display the current buffer if BUFFER is nil.Fbrowse-url-of-dired-file
  8722. In Dired, ask a WWW browser to display the file named on this line.Fbyte-force-recompile
  8723. Recompile every `.el' file in DIRECTORY that already has a `.elc' file.
  8724. Files in subdirectories of DIRECTORY are processed also.Fbyte-recompile-directory
  8725. Recompile every `.el' file in DIRECTORY that needs recompilation.
  8726. This is if a `.elc' file exists but is older than the `.el' file.
  8727. Files in subdirectories of DIRECTORY are processed also.
  8728.  
  8729. If the `.elc' file does not exist, normally the `.el' file is *not* compiled.
  8730. But a prefix argument (optional second arg) means ask user,
  8731. for each such `.el' file, whether to compile it.  Prefix argument 0 means
  8732. don't ask and compile the file anyway.
  8733.  
  8734. A nonzero prefix argument also means ask about each subdirectory.
  8735.  
  8736. If the third argument FORCE is non-nil,
  8737. recompile every `.el' file that already has a `.elc' file.Fbyte-compile-file
  8738. Compile a file of Lisp code named FILENAME into a file of byte code.
  8739. The output file's name is made by appending `c' to the end of FILENAME.
  8740. With prefix arg (noninteractively: 2nd arg), load the file after compiling.Fcompile-defun
  8741. Compile and evaluate the current top-level form.
  8742. Print the result in the minibuffer.
  8743. With argument, insert value in current buffer after the form.Fbyte-compile
  8744. If FORM is a symbol, byte-compile its function definition.
  8745. If FORM is a lambda or a macro, byte-compile it as a function.Fdisplay-call-tree
  8746. Display a call graph of a specified file.
  8747. This lists which functions have been called, what functions called
  8748. them, and what functions they call.  The list includes all functions
  8749. whose definitions have been compiled in this Emacs session, as well as
  8750. all functions called by those functions.
  8751.  
  8752. The call graph does not include macros, inline functions, or
  8753. primitives that the byte-code interpreter knows about directly (eq,
  8754. cons, etc.).
  8755.  
  8756. The call tree also lists those functions which are not known to be called
  8757. (that is, to which no calls have been compiled), and which cannot be
  8758. invoked interactively.Fbatch-byte-compile
  8759. Run `byte-compile-file' on the files remaining on the command line.
  8760. Use this from the command line, with `-batch';
  8761. it won't work in an interactive Emacs.
  8762. Each file is processed even if an error occurred previously.
  8763. For example, invoke "emacs -batch -f batch-byte-compile $emacs/ ~/*.el"Fbatch-byte-recompile-directory
  8764. Runs `byte-recompile-directory' on the dirs remaining on the command line.
  8765. Must be used only with `-batch', and kills Emacs on completion.
  8766. For example, invoke `emacs -batch -f batch-byte-recompile-directory .'.Flist-yahrzeit-dates
  8767. List Yahrzeit dates for *Gregorian* DEATH-DATE from START-YEAR to END-YEAR.
  8768. When called interactively from the calendar window, the date of death is taken
  8769. from the cursor position.Vcalendar-week-start-day
  8770. *The day of the week on which a week in the calendar begins.
  8771. 0 means Sunday (default), 1 means Monday, and so on.Vcalendar-offset
  8772. *The offset of the principal month from the center of the calendar window.
  8773. 0 means the principal month is in the center (default), -1 means on the left,
  8774. +1 means on the right.  Larger (or smaller) values push the principal month off
  8775. the screen.Vview-diary-entries-initially
  8776. *Non-nil means display current date's diary entries on entry.
  8777. The diary is displayed in another window when the calendar is first displayed,
  8778. if the current date is visible.  The number of days of diary entries displayed
  8779. is governed by the variable `number-of-diary-entries'.Vnumber-of-diary-entries
  8780. *Specifies how many days of diary entries are to be displayed initially.
  8781. This variable affects the diary display when the command M-x diary is used,
  8782. or if the value of the variable `view-diary-entries-initially' is t.  For
  8783. example, if the default value 1 is used, then only the current day's diary
  8784. entries will be displayed.  If the value 2 is used, then both the current
  8785. day's and the next day's entries will be displayed.
  8786.  
  8787. The value can also be a vector such as [0 2 2 2 2 4 1]; this value
  8788. says to display no diary entries on Sunday, the display the entries
  8789. for the current date and the day after on Monday through Thursday,
  8790. display Friday through Monday's entries on Friday, and display only
  8791. Saturday's entries on Saturday.
  8792.  
  8793. This variable does not affect the diary display with the `d' command
  8794. from the calendar; in that case, the prefix argument controls the
  8795. number of days of diary entries displayed.Vmark-diary-entries-in-calendar
  8796. *Non-nil means mark dates with diary entries, in the calendar window.
  8797. The marking symbol is specified by the variable `diary-entry-marker'.Vview-calendar-holidays-initially
  8798. *Non-nil means display holidays for current three month period on entry.
  8799. The holidays are displayed in another window when the calendar is first
  8800. displayed.Vmark-holidays-in-calendar
  8801. *Non-nil means mark dates of holidays in the calendar window.
  8802. The marking symbol is specified by the variable `calendar-holiday-marker'.Vall-hebrew-calendar-holidays
  8803. *If nil, show only major holidays from the Hebrew calendar.
  8804. This means only those Jewish holidays that appear on secular calendars.
  8805.  
  8806. If t, show all the holidays that would appear in a complete Hebrew calendar.Vall-christian-calendar-holidays
  8807. *If nil, show only major holidays from the Christian calendar.
  8808. This means only those Christian holidays that appear on secular calendars.
  8809.  
  8810. If t, show all the holidays that would appear in a complete Christian
  8811. calendar.Vall-islamic-calendar-holidays
  8812. *If nil, show only major holidays from the Islamic calendar.
  8813. This means only those Islamic holidays that appear on secular calendars.
  8814.  
  8815. If t, show all the holidays that would appear in a complete Islamic
  8816. calendar.Vcalendar-load-hook
  8817. *List of functions to be called after the calendar is first loaded.
  8818. This is the place to add key bindings to `calendar-mode-map'.Vinitial-calendar-window-hook
  8819. *List of functions to be called when the calendar window is first opened.
  8820. The functions invoked are called after the calendar window is opened, but
  8821. once opened is never called again.  Leaving the calendar with the `q' command
  8822. and reentering it will cause these functions to be called again.Vtoday-visible-calendar-hook
  8823. *List of functions called whenever the current date is visible.
  8824. This can be used, for example, to replace today's date with asterisks; a
  8825. function `calendar-star-date' is included for this purpose:
  8826.     (setq today-visible-calendar-hook 'calendar-star-date)
  8827. It can also be used to mark the current date with `calendar-today-marker';
  8828. a function is also provided for this:
  8829.     (setq today-visible-calendar-hook 'calendar-mark-today)
  8830.  
  8831. The corresponding variable `today-invisible-calendar-hook' is the list of
  8832. functions called when the calendar function was called when the current
  8833. date is not visible in the window.
  8834.  
  8835. Other than the use of the provided functions, the changing of any
  8836. characters in the calendar buffer by the hooks may cause the failure of the
  8837. functions that move by days and weeks.Vtoday-invisible-calendar-hook
  8838. *List of functions called whenever the current date is not visible.
  8839.  
  8840. The corresponding variable `today-visible-calendar-hook' is the list of
  8841. functions called when the calendar function was called when the current
  8842. date is visible in the window.
  8843.  
  8844. Other than the use of the provided functions, the changing of any
  8845. characters in the calendar buffer by the hooks may cause the failure of the
  8846. functions that move by days and weeks.Vdiary-file
  8847. *Name of the file in which one's personal diary of dates is kept.
  8848.  
  8849. The file's entries are lines in any of the forms
  8850.  
  8851.             MONTH/DAY
  8852.             MONTH/DAY/YEAR
  8853.             MONTHNAME DAY
  8854.             MONTHNAME DAY, YEAR
  8855.             DAYNAME
  8856.  
  8857. at the beginning of the line; the remainder of the line is the diary entry
  8858. string for that date.  MONTH and DAY are one or two digit numbers, YEAR is
  8859. a number and may be written in full or abbreviated to the final two digits.
  8860. If the date does not contain a year, it is generic and applies to any year.
  8861. DAYNAME entries apply to any date on which is on that day of the week.
  8862. MONTHNAME and DAYNAME can be spelled in full, abbreviated to three
  8863. characters (with or without a period), capitalized or not.  Any of DAY,
  8864. MONTH, or MONTHNAME, YEAR can be `*' which matches any day, month, or year,
  8865. respectively.
  8866.  
  8867. The European style (in which the day precedes the month) can be used
  8868. instead, if you execute `european-calendar' when in the calendar, or set
  8869. `european-calendar-style' to t in your .emacs file.  The European forms are
  8870.  
  8871.             DAY/MONTH
  8872.             DAY/MONTH/YEAR
  8873.             DAY MONTHNAME
  8874.             DAY MONTHNAME YEAR
  8875.             DAYNAME
  8876.  
  8877. To revert to the default American style from the European style, execute
  8878. `american-calendar' in the calendar.
  8879.  
  8880. A diary entry can be preceded by the character
  8881. `diary-nonmarking-symbol' (ordinarily `&') to make that entry
  8882. nonmarking--that is, it will not be marked on dates in the calendar
  8883. window but will appear in a diary window.
  8884.  
  8885. Multiline diary entries are made by indenting lines after the first with
  8886. either a TAB or one or more spaces.
  8887.  
  8888. Lines not in one the above formats are ignored.  Here are some sample diary
  8889. entries (in the default American style):
  8890.  
  8891.      12/22/1988 Twentieth wedding anniversary!!
  8892.      &1/1. Happy New Year!
  8893.      10/22 Ruth's birthday.
  8894.      21: Payday
  8895.      Tuesday--weekly meeting with grad students at 10am
  8896.               Supowit, Shen, Bitner, and Kapoor to attend.
  8897.      1/13/89 Friday the thirteenth!!
  8898.      &thu 4pm squash game with Lloyd.
  8899.      mar 16 Dad's birthday
  8900.      April 15, 1989 Income tax due.
  8901.      &* 15 time cards due.
  8902.  
  8903. If the first line of a diary entry consists only of the date or day name with
  8904. no trailing blanks or punctuation, then that line is not displayed in the
  8905. diary window; only the continuation lines is shown.  For example, the
  8906. single diary entry
  8907.  
  8908.      02/11/1989
  8909.       Bill Blattner visits Princeton today
  8910.       2pm Cognitive Studies Committee meeting
  8911.       2:30-5:30 Lizzie at Lawrenceville for `Group Initiative'
  8912.       4:00pm Jamie Tappenden
  8913.       7:30pm Dinner at George and Ed's for Alan Ryan
  8914.       7:30-10:00pm dance at Stewart Country Day School
  8915.  
  8916. will appear in the diary window without the date line at the beginning.  This
  8917. facility allows the diary window to look neater, but can cause confusion if
  8918. used with more than one day's entries displayed.
  8919.  
  8920. Diary entries can be based on Lisp sexps.  For example, the diary entry
  8921.  
  8922.       %%(diary-block 11 1 1990 11 10 1990) Vacation
  8923.  
  8924. causes the diary entry "Vacation" to appear from November 1 through November
  8925. 10, 1990.  Other functions available are `diary-float', `diary-anniversary',
  8926. `diary-cyclic', `diary-day-of-year', `diary-iso-date', `diary-french-date',
  8927. `diary-hebrew-date', `diary-islamic-date', `diary-mayan-date',
  8928. `diary-chinese-date', `diary-coptic-date', `diary-ethiopic-date',
  8929. `diary-persian-date', `diary-yahrzeit', `diary-sunrise-sunset',
  8930. `diary-phases-of-moon', `diary-parasha', `diary-omer', `diary-rosh-hodesh',
  8931. and `diary-sabbath-candles'.  See the documentation for the function
  8932. `list-sexp-diary-entries' for more details.
  8933.  
  8934. Diary entries based on the Hebrew and/or the Islamic calendar are also
  8935. possible, but because these are somewhat slow, they are ignored
  8936. unless you set the `nongregorian-diary-listing-hook' and the
  8937. `nongregorian-diary-marking-hook' appropriately.  See the documentation
  8938. for these functions for details.
  8939.  
  8940. Diary files can contain directives to include the contents of other files; for
  8941. details, see the documentation for the variable `list-diary-entries-hook'.Vdiary-nonmarking-symbol
  8942. *Symbol indicating that a diary entry is not to be marked in the calendar.Vhebrew-diary-entry-symbol
  8943. *Symbol indicating a diary entry according to the Hebrew calendar.Vislamic-diary-entry-symbol
  8944. *Symbol indicating a diary entry according to the Islamic calendar.Vdiary-include-string
  8945. *The string indicating inclusion of another file of diary entries.
  8946. See the documentation for the function `include-other-diary-files'.Vsexp-diary-entry-symbol
  8947. *The string used to indicate a sexp diary entry in diary-file.
  8948. See the documentation for the function `list-sexp-diary-entries'.Vabbreviated-calendar-year
  8949. *Interpret a two-digit year DD in a diary entry as either 19DD or 20DD.
  8950. For the Gregorian calendar; similarly for the Hebrew and Islamic calendars.
  8951. If this variable is nil, years must be written in full.Veuropean-calendar-style
  8952. *Use the European style of dates in the diary and in any displays.
  8953. If this variable is t, a date 1/2/1990 would be interpreted as February 1,
  8954. 1990.  The accepted European date styles are
  8955.  
  8956.             DAY/MONTH
  8957.             DAY/MONTH/YEAR
  8958.             DAY MONTHNAME
  8959.             DAY MONTHNAME YEAR
  8960.             DAYNAME
  8961.  
  8962. Names can be capitalized or not, written in full, or abbreviated to three
  8963. characters with or without a period.Vamerican-date-diary-pattern
  8964. *List of pseudo-patterns describing the American patterns of date used.
  8965. See the documentation of `diary-date-forms' for an explanation.Veuropean-date-diary-pattern
  8966. *List of pseudo-patterns describing the European patterns of date used.
  8967. See the documentation of `diary-date-forms' for an explanation.Veuropean-calendar-display-form
  8968. *Pseudo-pattern governing the way a date appears in the European style.
  8969. See the documentation of calendar-date-display-form for an explanation.Vamerican-calendar-display-form
  8970. *Pseudo-pattern governing the way a date appears in the American style.
  8971. See the documentation of `calendar-date-display-form' for an explanation.Vprint-diary-entries-hook
  8972. *List of functions called after a temporary diary buffer is prepared.
  8973. The buffer shows only the diary entries currently visible in the diary
  8974. buffer.  The default just does the printing.  Other uses might include, for
  8975. example, rearranging the lines into order by day and time, saving the buffer
  8976. instead of deleting it, or changing the function used to do the printing.Vlist-diary-entries-hook
  8977. *List of functions called after diary file is culled for relevant entries.
  8978. It is to be used for diary entries that are not found in the diary file.
  8979.  
  8980. A function `include-other-diary-files' is provided for use as the value of
  8981. this hook.  This function enables you to use shared diary files together
  8982. with your own.  The files included are specified in the diary file by lines
  8983. of the form
  8984.  
  8985.         #include "filename"
  8986.  
  8987. This is recursive; that is, #include directives in files thus included are
  8988. obeyed.  You can change the "#include" to some other string by changing
  8989. the variable `diary-include-string'.  When you use `include-other-diary-files'
  8990. as part of the list-diary-entries-hook, you will probably also want to use the
  8991. function `mark-included-diary-files' as part of `mark-diary-entries-hook'.
  8992.  
  8993. For example, you could use
  8994.  
  8995.      (setq list-diary-entries-hook
  8996.        '(include-other-diary-files sort-diary-entries))
  8997.      (setq diary-display-hook 'fancy-diary-display)
  8998.  
  8999. in your `.emacs' file to cause the fancy diary buffer to be displayed with
  9000. diary entries from various included files, each day's entries sorted into
  9001. lexicographic order.Vdiary-hook
  9002. *List of functions called after the display of the diary.
  9003. Can be used for appointment notification.Vdiary-display-hook
  9004. *List of functions that handle the display of the diary.
  9005. If nil (the default), `simple-diary-display' is used.  Use `ignore' for no
  9006. diary display.
  9007.  
  9008. Ordinarily, this just displays the diary buffer (with holidays indicated in
  9009. the mode line), if there are any relevant entries.  At the time these
  9010. functions are called, the variable `diary-entries-list' is a list, in order
  9011. by date, of all relevant diary entries in the form of ((MONTH DAY YEAR)
  9012. STRING), where string is the diary entry for the given date.  This can be
  9013. used, for example, a different buffer for display (perhaps combined with
  9014. holidays), or produce hard copy output.
  9015.  
  9016. A function `fancy-diary-display' is provided as an alternative
  9017. choice for this hook; this function prepares a special noneditable diary
  9018. buffer with the relevant diary entries that has neat day-by-day arrangement
  9019. with headings.  The fancy diary buffer will show the holidays unless the
  9020. variable `holidays-in-diary-buffer' is set to nil.  Ordinarily, the fancy
  9021. diary buffer will not show days for which there are no diary entries, even
  9022. if that day is a holiday; if you want such days to be shown in the fancy
  9023. diary buffer, set the variable `diary-list-include-blanks' to t.Vnongregorian-diary-listing-hook
  9024. *List of functions called for listing diary file and included files.
  9025. As the files are processed for diary entries, these functions are used to cull
  9026. relevant entries.  You can use either or both of `list-hebrew-diary-entries'
  9027. and `list-islamic-diary-entries'.  The documentation for these functions
  9028. describes the style of such diary entries.Vmark-diary-entries-hook
  9029. *List of functions called after marking diary entries in the calendar.
  9030.  
  9031. A function `mark-included-diary-files' is also provided for use as the
  9032. mark-diary-entries-hook; it enables you to use shared diary files together
  9033. with your own.  The files included are specified in the diary file by lines
  9034. of the form
  9035.         #include "filename"
  9036. This is recursive; that is, #include directives in files thus included are
  9037. obeyed.  You can change the "#include" to some other string by changing the
  9038. variable `diary-include-string'.  When you use `mark-included-diary-files' as
  9039. part of the mark-diary-entries-hook, you will probably also want to use the
  9040. function `include-other-diary-files' as part of `list-diary-entries-hook'.Vnongregorian-diary-marking-hook
  9041. *List of functions called for marking diary file and included files.
  9042. As the files are processed for diary entries, these functions are used to cull
  9043. relevant entries.  You can use either or both of `mark-hebrew-diary-entries'
  9044. and `mark-islamic-diary-entries'.  The documentation for these functions
  9045. describes the style of such diary entries.Vdiary-list-include-blanks
  9046. *If nil, do not include days with no diary entry in the list of diary entries.
  9047. Such days will then not be shown in the the fancy diary buffer, even if they
  9048. are holidays.Vholidays-in-diary-buffer
  9049. *Non-nil means include holidays in the diary display.
  9050. The holidays appear in the mode line of the diary buffer, or in the
  9051. fancy diary buffer next to the date.  This slows down the diary functions
  9052. somewhat; setting it to nil makes the diary display faster.Vgeneral-holidays
  9053. *General holidays.  Default value is for the United States.
  9054. See the documentation for `calendar-holidays' for details.Voriental-holidays
  9055. *Oriental holidays.
  9056. See the documentation for `calendar-holidays' for details.Vlocal-holidays
  9057. *Local holidays.
  9058. See the documentation for `calendar-holidays' for details.Vother-holidays
  9059. *User defined holidays.
  9060. See the documentation for `calendar-holidays' for details.Vhebrew-holidays
  9061. *Jewish holidays.
  9062. See the documentation for `calendar-holidays' for details.Vchristian-holidays
  9063. *Christian holidays.
  9064. See the documentation for `calendar-holidays' for details.Vislamic-holidays
  9065. *Islamic holidays.
  9066. See the documentation for `calendar-holidays' for details.Vsolar-holidays
  9067. *Sun-related holidays.
  9068. See the documentation for `calendar-holidays' for details.Vcalendar-setup
  9069. The frame set up of the calendar.
  9070. The choices are `one-frame' (calendar and diary together in one separate,
  9071. dedicated frame) or `two-frames' (calendar and diary in separate, dedicated
  9072. frames); with any other value the current frame is used.Fcalendar
  9073. Choose between the one frame, two frame, or basic calendar displays.
  9074. The original function `calendar' has been renamed `calendar-basic-setup'.Fdescribe-buffer-case-table
  9075. Describe the case table of the current buffer.Fset-case-syntax-delims
  9076. Make characters L and R a matching pair of non-case-converting delimiters.
  9077. This sets the entries for L and R in TABLE, which is a string
  9078. that will be used as the downcase part of a case table.
  9079. It also modifies `standard-syntax-table' to
  9080. indicate left and right delimiters.Fset-case-syntax-pair
  9081. Make characters UC and LC a pair of inter-case-converting letters.
  9082. This sets the entries for characters UC and LC in TABLE, which is a string
  9083. that will be used as the downcase part of a case table.
  9084. It also modifies `standard-syntax-table' to give them the syntax of
  9085. word constituents.Fset-case-syntax
  9086. Make characters C case-invariant with syntax SYNTAX.
  9087. This sets the entries for character C in TABLE, which is a string
  9088. that will be used as the downcase part of a case table.
  9089. It also modifies `standard-syntax-table'.
  9090. SYNTAX should be " ", "w", "." or "_".Fc-mode
  9091. Major mode for editing K&R and ANSI C code.
  9092. To submit a problem report, enter `\[c-submit-bug-report]' from a
  9093. c-mode buffer.  This automatically sets up a mail buffer with version
  9094. information already added.  You just need to add a description of the
  9095. problem, including a reproducible test case and send the message.
  9096.  
  9097. To see what version of cc-mode you are running, enter `\[c-version]'.
  9098.  
  9099. The hook variable `c-mode-hook' is run with no args, if that value is
  9100. bound and has a non-nil value.  Also the hook `c-mode-common-hook' is
  9101. run first.
  9102.  
  9103. Key bindings:
  9104. \{c-mode-map}Fc++-mode
  9105. Major mode for editing C++ code.
  9106. To submit a problem report, enter `\[c-submit-bug-report]' from a
  9107. c++-mode buffer.  This automatically sets up a mail buffer with
  9108. version information already added.  You just need to add a description
  9109. of the problem, including a reproducible test case, and send the
  9110. message.
  9111.  
  9112. To see what version of cc-mode you are running, enter `\[c-version]'.
  9113.  
  9114. The hook variable `c++-mode-hook' is run with no args, if that
  9115. variable is bound and has a non-nil value.  Also the hook
  9116. `c-mode-common-hook' is run first.
  9117.  
  9118. Key bindings:
  9119. \{c++-mode-map}Fobjc-mode
  9120. Major mode for editing Objective C code.
  9121. To submit a problem report, enter `\[c-submit-bug-report]' from an
  9122. objc-mode buffer.  This automatically sets up a mail buffer with
  9123. version information already added.  You just need to add a description
  9124. of the problem, including a reproducible test case, and send the
  9125. message.
  9126.  
  9127. To see what version of cc-mode you are running, enter `\[c-version]'.
  9128.  
  9129. The hook variable `objc-mode-hook' is run with no args, if that value
  9130. is bound and has a non-nil value.  Also the hook `c-mode-common-hook'
  9131. is run first.
  9132.  
  9133. Key bindings:
  9134. \{objc-mode-map}Fjava-mode
  9135. Major mode for editing Java code.
  9136. To submit a problem report, enter `\[c-submit-bug-report]' from an
  9137. java-mode buffer.  This automatically sets up a mail buffer with
  9138. version information already added.  You just need to add a description
  9139. of the problem, including a reproducible test case and send the
  9140. message.
  9141.  
  9142. To see what version of cc-mode you are running, enter `\[c-version]'.
  9143.  
  9144. The hook variable `java-mode-hook' is run with no args, if that value
  9145. is bound and has a non-nil value.  Also the common hook
  9146. `c-mode-common-hook' is run first.
  9147.  
  9148. Key bindings:
  9149. \{java-mode-map}Fc-set-style
  9150. Set cc-mode variables to use one of several different indentation styles.
  9151. STYLENAME is a string representing the desired style from the list of
  9152. styles described in the variable `c-style-alist'.  See that variable
  9153. for details of setting up styles.Frepeat-matching-complex-command
  9154. Edit and re-evaluate complex command with name matching PATTERN.
  9155. Matching occurrences are displayed, most recent first, until you select
  9156. a form for evaluation.  If PATTERN is empty (or nil), every form in the
  9157. command history is offered.  The form is placed in the minibuffer for
  9158. editing and the result is evaluated.Flist-command-history
  9159. List history of commands typed to minibuffer.
  9160. The number of commands listed is controlled by `list-command-history-max'.
  9161. Calls value of `list-command-history-filter' (if non-nil) on each history
  9162. element to judge if that element should be excluded from the list.
  9163.  
  9164. The buffer is left in Command History mode.Fcommand-history-mode
  9165. Major mode for examining commands from `command-history'.
  9166. The number of commands listed is controlled by `list-command-history-max'.
  9167. The command history is filtered by `list-command-history-filter' if non-nil.
  9168. Use \<command-history-map>\[command-history-repeat] to repeat the command on the current line.
  9169.  
  9170. Otherwise much like Emacs-Lisp Mode except that there is no self-insertion
  9171. and digits provide prefix arguments.  Tab does not indent.
  9172. \{command-history-map}
  9173. Calls the value of `command-history-hook' if that is non-nil.
  9174. The Command History listing is recomputed each time this mode is invoked.Frun-scheme
  9175. Run an inferior Scheme process, input and output via buffer *scheme*.
  9176. If there is a process already running in `*scheme*', switch to that buffer.
  9177. With argument, allows you to edit the command line (default is value
  9178. of `scheme-program-name').  Runs the hooks `inferior-scheme-mode-hook'
  9179. (after the `comint-mode-hook' is run).
  9180. (Type \[describe-mode] in the process buffer for a list of commands.)Fmake-comint
  9181. Make a comint process NAME in a buffer, running PROGRAM.
  9182. The name of the buffer is made by surrounding NAME with `*'s.
  9183. PROGRAM should be either a string denoting an executable program to create
  9184. via `start-process', or a cons pair of the form (HOST . SERVICE) denoting a TCP
  9185. connection to be opened via `open-network-stream'.  If there is already a
  9186. running process in that buffer, it is not restarted.  Optional third arg
  9187. STARTFILE is the name of a file to send the contents of to the process.
  9188.  
  9189. If PROGRAM is a string, any more args are arguments to PROGRAM.Fcomint-run
  9190. Run PROGRAM in a comint buffer and switch to it.
  9191. The buffer name is made by surrounding the file name of PROGRAM with `*'s.
  9192. The file name is used to make a symbol name, such as `comint-sh-hook', and any
  9193. hooks on this symbol are run in the buffer.
  9194. See `make-comint' and `comint-exec'.Fcompare-windows
  9195. Compare text in current window with text in next window.
  9196. Compares the text starting at point in each window,
  9197. moving over text in each one as far as they match.
  9198.  
  9199. This command pushes the mark in each window
  9200. at the prior location of point in that window.
  9201. If both windows display the same buffer,
  9202. the mark is pushed twice in that buffer:
  9203. first in the other window, then in the selected window.
  9204.  
  9205. A prefix arg means ignore changes in whitespace.
  9206. The variable `compare-windows-whitespace' controls how whitespace is skipped.
  9207. If `compare-ignore-case' is non-nil, changes in case are also ignored.Vcompilation-mode-hook
  9208. *List of hook functions run by `compilation-mode' (see `run-hooks').Vcompilation-window-height
  9209. *Number of lines in a compilation window.  If nil, use Emacs default.Vcompilation-buffer-name-function
  9210. Function to compute the name of a compilation buffer.
  9211. The function receives one argument, the name of the major mode of the
  9212. compilation buffer.  It should return a string.
  9213. nil means compute the name with `(concat "*" (downcase major-mode) "*")'.Vcompilation-finish-function
  9214. *Function to call when a compilation process finishes.
  9215. It is called with two arguments: the compilation buffer, and a string
  9216. describing how the process finished.Vcompilation-search-path
  9217. *List of directories to search for source files named in error messages.
  9218. Elements should be directory names, not file names of directories.
  9219. nil as an element means to try the default directory.Fcompile
  9220. Compile the program including the current buffer.  Default: run `make'.
  9221. Runs COMMAND, a shell command, in a separate process asynchronously
  9222. with output going to the buffer `*compilation*'.
  9223.  
  9224. You can then use the command \[next-error] to find the next error message
  9225. and move to the source code that caused it.
  9226.  
  9227. Interactively, prompts for the command if `compilation-read-command' is
  9228. non-nil; otherwise uses `compile-command'.  With prefix arg, always prompts.
  9229.  
  9230. To run more than one compilation at once, start one and rename the
  9231. `*compilation*' buffer to some other name with \[rename-buffer].
  9232. Then start the next one.
  9233.  
  9234. The name used for the buffer is actually whatever is returned by
  9235. the function in `compilation-buffer-name-function', so you can set that
  9236. to a function that generates a unique name.Fgrep
  9237. Run grep, with user-specified args, and collect output in a buffer.
  9238. While grep runs asynchronously, you can use the \[next-error] command
  9239. to find the text that grep hits refer to.
  9240.  
  9241. This command uses a special history list for its arguments, so you can
  9242. easily repeat a grep command.Fcompilation-mode
  9243. Major mode for compilation log buffers.
  9244. \<compilation-mode-map>To visit the source for a line-numbered error,
  9245. move point to the error message line and type \[compile-goto-error].
  9246. To kill the compilation, type \[kill-compilation].
  9247.  
  9248. Runs `compilation-mode-hook' with `run-hooks' (which see).Fcompilation-minor-mode
  9249. Toggle compilation minor mode.
  9250. With arg, turn compilation mode on if and only if arg is positive.
  9251. See `compilation-mode'.
  9252. Turning the mode on runs the normal hook `compilation-minor-mode-hook'.Fnext-error
  9253. Visit next compilation error message and corresponding source code.
  9254. This operates on the output from the \[compile] command.
  9255. If all preparsed error messages have been processed,
  9256. the error message buffer is checked for new ones.
  9257.  
  9258. A prefix arg specifies how many error messages to move;
  9259. negative means move back to previous error messages.
  9260. Just C-u as a prefix means reparse the error message buffer
  9261. and start at the first error.
  9262.  
  9263. \[next-error] normally applies to the most recent compilation started,
  9264. but as long as you are in the middle of parsing errors from one compilation
  9265. output buffer, you stay with that compilation output buffer.
  9266.  
  9267. Use \[next-error] in a compilation output buffer to switch to
  9268. processing errors from that compilation.
  9269.  
  9270. See variables `compilation-parse-errors-function' and
  9271. `compilation-error-regexp-alist' for customization ideas.Fcookie
  9272. Return a random phrase from PHRASE-FILE.  When the phrase file
  9273. is read in, display STARTMSG at beginning of load, ENDMSG at end.Fcookie-insert
  9274. Insert random phrases from PHRASE-FILE; COUNT of them.  When the phrase file
  9275. is read in, display STARTMSG at beginning of load, ENDMSG at end.Fcookie-snarf
  9276. Reads in the PHRASE-FILE, returns it as a vector of strings.
  9277. Emit STARTMSG and ENDMSG before and after.  Caches the result; second
  9278. and subsequent calls on the same file won't go to disk.Fshuffle-vector
  9279. Randomly permute the elements of VECTOR (all permutations equally likely)Fcopyright-update
  9280. Update the copyright notice at the beginning of the buffer to indicate
  9281. the current year.  If optional prefix ARG is given replace the years in the
  9282. notice rather than adding the current year after them.  If necessary and
  9283. `copyright-current-gpl-version' is set, the copying permissions following the
  9284. copyright, if any, are updated as well.Fcopyright
  9285. Insert a copyright by $ORGANIZATION notice at cursor.Fcpp-highlight-buffer
  9286. Highlight C code according to preprocessor conditionals.
  9287. This command pops up a buffer which you should edit to specify
  9288. what kind of highlighting to use, and the criteria for highlighting.
  9289. A prefix arg suppresses display of that buffer.Fcpp-parse-edit
  9290. Edit display information for cpp conditionals.Fdabbrev-completion
  9291. Completion on current word.
  9292. Like \[dabbrev-expand] but finds all expansions in the current buffer
  9293. and presents suggestions for completion.
  9294.  
  9295. With a prefix argument, it searches all buffers accepted by the
  9296. function pointed out by `dabbrev-friend-buffer-function' to find the
  9297. completions.
  9298.  
  9299. If the prefix argument is 16 (which comes from C-u C-u),
  9300. then it searches *all* buffers.
  9301.  
  9302. With no prefix argument, it reuses an old completion list
  9303. if there is a suitable one already.Fdabbrev-expand
  9304. Expand previous word "dynamically".
  9305.  
  9306. Expands to the most recent, preceding word for which this is a prefix.
  9307. If no suitable preceding word is found, words following point are
  9308. considered.  If still no suitable word is found, then look in the
  9309. buffers accepted by the function pointed out by variable
  9310. `dabbrev-friend-buffer-function'.
  9311.  
  9312. A positive prefix argument, N, says to take the Nth backward *distinct*
  9313. possibility.  A negative argument says search forward.
  9314.  
  9315. If the cursor has not moved from the end of the previous expansion and
  9316. no argument is given, replace the previously-made expansion
  9317. with the next possible expansion not yet tried.
  9318.  
  9319. The variable `dabbrev-backward-only' may be used to limit the
  9320. direction of search to backward if set non-nil.
  9321.  
  9322. See also `dabbrev-abbrev-char-regexp' and \[dabbrev-completion].Fdebug
  9323. Enter debugger.  To return, type \<debugger-mode-map>`\[debugger-continue]'.
  9324. Arguments are mainly for use when this is called from the internals
  9325. of the evaluator.
  9326.  
  9327. You may call with no args, or you may pass nil as the first arg and
  9328. any other args you like.  In that case, the list of args after the
  9329. first will be printed into the backtrace buffer.Fdebug-on-entry
  9330. Request FUNCTION to invoke debugger each time it is called.
  9331. If you tell the debugger to continue, FUNCTION's execution proceeds.
  9332. This works by modifying the definition of FUNCTION,
  9333. which must be written in Lisp, not predefined.
  9334. Use \[cancel-debug-on-entry] to cancel the effect of this command.
  9335. Redefining FUNCTION also cancels it.Fcancel-debug-on-entry
  9336. Undo effect of \[debug-on-entry] on FUNCTION.
  9337. If argument is nil or an empty string, cancel for all functions.Fdecipher
  9338. Format a buffer of ciphertext for cryptanalysis and enter Decipher mode.Fdecipher-mode
  9339. Major mode for decrypting monoalphabetic substitution ciphers.
  9340. Lower-case letters enter plaintext.
  9341. Upper-case letters are commands.
  9342.  
  9343. The buffer is made read-only so that normal Emacs commands cannot
  9344. modify it.
  9345.  
  9346. The most useful commands are:
  9347. \<decipher-mode-map>
  9348. \[decipher-digram-list]  Display a list of all digrams & their frequency
  9349. \[decipher-frequency-count]  Display the frequency of each ciphertext letter
  9350. \[decipher-adjacency-list]  Show adjacency list for current letter (lists letters appearing next to it)
  9351. \[decipher-make-checkpoint]  Save the current cipher alphabet (checkpoint)
  9352. \[decipher-restore-checkpoint]  Restore a saved cipher alphabet (checkpoint)Fdelete-selection-mode
  9353. Toggle Delete Selection mode.
  9354. When ON, typed text replaces the selection if the selection is active.
  9355. When OFF, typed text is just inserted at point.Fdefine-derived-mode
  9356. Create a new mode as a variant of an existing mode.
  9357.  
  9358. The arguments to this command are as follow:
  9359.  
  9360. CHILD:     the name of the command for the derived mode.
  9361. PARENT:    the name of the command for the parent mode (ie. text-mode).
  9362. NAME:      a string which will appear in the status line (ie. "Hypertext")
  9363. DOCSTRING: an optional documentation string--if you do not supply one,
  9364.            the function will attempt to invent something useful.
  9365. BODY:      forms to execute just before running the
  9366.            hooks for the new mode.
  9367.  
  9368. Here is how you could define LaTeX-Thesis mode as a variant of LaTeX mode:
  9369.  
  9370.   (define-derived-mode LaTeX-thesis-mode LaTeX-mode "LaTeX-Thesis")
  9371.  
  9372. You could then make new key bindings for `LaTeX-thesis-mode-map'
  9373. without changing regular LaTeX mode.  In this example, BODY is empty,
  9374. and DOCSTRING is generated by default.
  9375.  
  9376. On a more complicated level, the following command uses sgml-mode as
  9377. the parent, and then sets the variable `case-fold-search' to nil:
  9378.  
  9379.   (define-derived-mode article-mode sgml-mode "Article"
  9380.     "Major mode for editing technical articles."
  9381.     (setq case-fold-search nil))
  9382.  
  9383. Note that if the documentation string had been left out, it would have
  9384. been generated automatically, with a reference to the keymap.Fderived-mode-init-mode-variables
  9385. Initialise variables for a new mode. 
  9386. Right now, if they don't already exist, set up a blank keymap, an
  9387. empty syntax table, and an empty abbrev table -- these will be merged
  9388. the first time the mode is used.Fdiary
  9389. Generate the diary window for ARG days starting with the current date.
  9390. If no argument is provided, the number of days of diary entries is governed
  9391. by the variable `number-of-diary-entries'.  This function is suitable for
  9392. execution in a `.emacs' file.Fdiff
  9393. Find and display the differences between OLD and NEW files.
  9394. Interactively the current buffer's file name is the default for NEW
  9395. and a backup file for NEW is the default for OLD.
  9396. With prefix arg, prompt for diff switches.Fdiff-backup
  9397. Diff this file with its backup file or vice versa.
  9398. Uses the latest backup, if there are several numerical backups.
  9399. If this file is a backup, diff it with its original.
  9400. The backup file is the first file given to `diff'.Vdired-listing-switches
  9401. *Switches passed to `ls' for dired.  MUST contain the `l' option.
  9402. May contain all other options that don't contradict `-l';
  9403. may contain even `F', `b', `i' and `s'.  See also the variable
  9404. `dired-ls-F-marks-symlinks' concerning the `F' switch.Vdired-chown-program
  9405. Name of chown command (usually `chown' or `/etc/chown').Vdired-ls-F-marks-symlinks
  9406. *Informs dired about how `ls -lF' marks symbolic links.
  9407. Set this to t if `ls' (or whatever program is specified by
  9408. `insert-directory-program') with `-lF' marks the symbolic link
  9409. itself with a trailing @ (usually the case under Ultrix).
  9410.  
  9411. Example: if `ln -s foo bar; ls -F bar' gives `bar -> foo', set it to
  9412. nil (the default), if it gives `bar@ -> foo', set it to t.
  9413.  
  9414. Dired checks if there is really a @ appended.  Thus, if you have a
  9415. marking `ls' program on one host and a non-marking on another host, and
  9416. don't care about symbolic links which really end in a @, you can
  9417. always set this variable to t.Vdired-trivial-filenames
  9418. *Regexp of files to skip when finding first file of a directory.
  9419. A value of nil means move to the subdir line.
  9420. A value of t means move to first file.Vdired-keep-marker-rename
  9421. *Controls marking of renamed files.
  9422. If t, files keep their previous marks when they are renamed.
  9423. If a character, renamed files (whether previously marked or not)
  9424. are afterward marked with that character.Vdired-keep-marker-copy
  9425. *Controls marking of copied files.
  9426. If t, copied files are marked if and as the corresponding original files were.
  9427. If a character, copied files are unconditionally marked with that character.Vdired-keep-marker-hardlink
  9428. *Controls marking of newly made hard links.
  9429. If t, they are marked if and as the files linked to were marked.
  9430. If a character, new links are unconditionally marked with that character.Vdired-keep-marker-symlink
  9431. *Controls marking of newly made symbolic links.
  9432. If t, they are marked if and as the files linked to were marked.
  9433. If a character, new links are unconditionally marked with that character.Vdired-dwim-target
  9434. *If non-nil, dired tries to guess a default target directory.
  9435. This means: if there is a dired buffer displayed in the next window,
  9436. use its current subdir, instead of the current subdir of this dired buffer.
  9437.  
  9438. The target is used in the prompt for file copy, rename etc.Vdired-copy-preserve-time
  9439. *If non-nil, Dired preserves the last-modified time in a file copy.
  9440. (This works on only some systems.)Fdired
  9441. "Edit" directory DIRNAME--delete, rename, print, etc. some files in it.
  9442. Optional second argument SWITCHES specifies the `ls' options used.
  9443. (Interactively, use a prefix argument to be able to specify SWITCHES.)
  9444. Dired displays a list of files in DIRNAME (which may also have
  9445. shell wildcards appended to select certain files).  If DIRNAME is a cons,
  9446. its first element is taken as the directory name and the rest as an explicit
  9447. list of files to make directory entries for.
  9448. \<dired-mode-map>You can move around in it with the usual commands.
  9449. You can flag files for deletion with \[dired-flag-file-deletion] and then
  9450. delete them by typing \[dired-do-flagged-delete].
  9451. Type \[describe-mode] after entering dired for more info.
  9452.  
  9453. If DIRNAME is already in a dired buffer, that buffer is used without refresh.Fdired-other-window
  9454. "Edit" directory DIRNAME.  Like `dired' but selects in another window.Fdired-other-frame
  9455. "Edit" directory DIRNAME.  Like `dired' but makes a new frame.Fdired-noselect
  9456. Like `dired' but returns the dired buffer as value, does not select it.Fdired-diff
  9457. Compare file at point with file FILE using `diff'.
  9458. FILE defaults to the file at the mark.
  9459. The prompted-for file is the first file given to `diff'.
  9460. With prefix arg, prompt for second argument SWITCHES,
  9461.  which is options for `diff'.Fdired-backup-diff
  9462. Diff this file with its backup file or vice versa.
  9463. Uses the latest backup, if there are several numerical backups.
  9464. If this file is a backup, diff it with its original.
  9465. The backup file is the first file given to `diff'.
  9466. With prefix arg, prompt for argument SWITCHES which is options for `diff'.Fdired-do-chmod
  9467. Change the mode of the marked (or next ARG) files.
  9468. This calls chmod, thus symbolic modes like `g+w' are allowed.Fdired-do-chgrp
  9469. Change the group of the marked (or next ARG) files.Fdired-do-chown
  9470. Change the owner of the marked (or next ARG) files.Fdired-do-print
  9471. Print the marked (or next ARG) files.
  9472. Uses the shell command coming from variables `lpr-command' and
  9473. `lpr-switches' as default.Fdired-do-shell-command
  9474. Run a shell command COMMAND on the marked files.
  9475. If no files are marked or a specific numeric prefix arg is given,
  9476. the next ARG files are used.  Just \[universal-argument] means the current file.
  9477. The prompt mentions the file(s) or the marker, as appropriate.
  9478.  
  9479. If there is output, it goes to a separate buffer.
  9480.  
  9481. Normally the command is run on each file individually.
  9482. However, if there is a `*' in the command then it is run
  9483. just once with the entire file list substituted there.
  9484.  
  9485. No automatic redisplay of dired buffers is attempted, as there's no
  9486. telling what files the command may have changed.  Type
  9487. \[dired-do-redisplay] to redisplay the marked files.
  9488.  
  9489. The shell command has the top level directory as working directory, so
  9490. output files usually are created there instead of in a subdir.Fdired-do-kill-lines
  9491. Kill all marked lines (not the files).
  9492. With a prefix argument, kill that many lines starting with the current line.
  9493. (A negative argument kills lines before the current line.)
  9494. To kill an entire subdirectory, go to its directory header line
  9495. and use this command with a prefix argument (the value does not matter).Fdired-do-compress
  9496. Compress or uncompress marked (or next ARG) files.Fdired-do-byte-compile
  9497. Byte compile marked (or next ARG) Emacs Lisp files.Fdired-do-load
  9498. Load the marked (or next ARG) Emacs Lisp files.Fdired-do-redisplay
  9499. Redisplay all marked (or next ARG) files.
  9500. If on a subdir line, redisplay that subdirectory.  In that case,
  9501. a prefix arg lets you edit the `ls' switches used for the new listing.Fdired-create-directory
  9502. Create a directory called DIRECTORY.Fdired-do-copy
  9503. Copy all marked (or next ARG) files, or copy the current file.
  9504. This normally preserves the last-modified date when copying.
  9505. When operating on just the current file, you specify the new name.
  9506. When operating on multiple or marked files, you specify a directory,
  9507. and new copies of these files are made in that directory
  9508. with the same names that the files currently have.Fdired-do-symlink
  9509. Make symbolic links to current file or all marked (or next ARG) files.
  9510. When operating on just the current file, you specify the new name.
  9511. When operating on multiple or marked files, you specify a directory
  9512. and new symbolic links are made in that directory
  9513. with the same names that the files currently have.Fdired-do-hardlink
  9514. Add names (hard links) current file or all marked (or next ARG) files.
  9515. When operating on just the current file, you specify the new name.
  9516. When operating on multiple or marked files, you specify a directory
  9517. and new hard links are made in that directory
  9518. with the same names that the files currently have.Fdired-do-rename
  9519. Rename current file or all marked (or next ARG) files.
  9520. When renaming just the current file, you specify the new name.
  9521. When renaming multiple or marked files, you specify a directory.Fdired-do-rename-regexp
  9522. Rename marked files containing REGEXP to NEWNAME.
  9523. As each match is found, the user must type a character saying
  9524.   what to do with it.  For directions, type \[help-command] at that time.
  9525. NEWNAME may contain \=\<n> or \& as in `query-replace-regexp'.
  9526. REGEXP defaults to the last regexp used.
  9527. With a zero prefix arg, renaming by regexp affects the complete
  9528.   pathname - usually only the non-directory part of file names is used
  9529.   and changed.Fdired-do-copy-regexp
  9530. Copy all marked files containing REGEXP to NEWNAME.
  9531. See function `dired-rename-regexp' for more info.Fdired-do-hardlink-regexp
  9532. Hardlink all marked files containing REGEXP to NEWNAME.
  9533. See function `dired-rename-regexp' for more info.Fdired-do-symlink-regexp
  9534. Symlink all marked files containing REGEXP to NEWNAME.
  9535. See function `dired-rename-regexp' for more info.Fdired-upcase
  9536. Rename all marked (or next ARG) files to upper case.Fdired-downcase
  9537. Rename all marked (or next ARG) files to lower case.Fdired-maybe-insert-subdir
  9538. Insert this subdirectory into the same dired buffer.
  9539. If it is already present, just move to it (type \[dired-do-redisplay] to refresh),
  9540.   else inserts it at its natural place (as `ls -lR' would have done).
  9541. With a prefix arg, you may edit the ls switches used for this listing.
  9542.   You can add `R' to the switches to expand the whole tree starting at
  9543.   this subdirectory.
  9544. This function takes some pains to conform to `ls -lR' output.Fdired-prev-subdir
  9545. Go to previous subdirectory, regardless of level.
  9546. When called interactively and not on a subdir line, go to this subdir's line.Fdired-goto-subdir
  9547. Go to end of header line of DIR in this dired buffer.
  9548. Return value of point on success, otherwise return nil.
  9549. The next char is either \n, or \r if DIR is hidden.Fdired-mark-subdir-files
  9550. Mark all files except `.' and `..'.Fdired-kill-subdir
  9551. Remove all lines of current subdirectory.
  9552. Lower levels are unaffected.Fdired-tree-up
  9553. Go up ARG levels in the dired tree.Fdired-tree-down
  9554. Go down in the dired tree.Fdired-hide-subdir
  9555. Hide or unhide the current subdirectory and move to next directory.
  9556. Optional prefix arg is a repeat factor.
  9557. Use \[dired-hide-all] to (un)hide all directories.Fdired-hide-all
  9558. Hide all subdirectories, leaving only their header lines.
  9559. If there is already something hidden, make everything visible again.
  9560. Use \[dired-hide-subdir] to (un)hide a particular subdirectory.Fdired-do-search
  9561. Search through all marked files for a match for REGEXP.
  9562. Stops when a match is found.
  9563. To continue searching for next match, use command \[tags-loop-continue].Fdired-do-query-replace
  9564. Do `query-replace-regexp' of FROM with TO, on all marked files.
  9565. Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
  9566. If you exit (\[keyboard-quit] or ESC), you can resume the query replace
  9567. with the command \[tags-loop-continue].Fdired-jump
  9568. Jump to dired buffer corresponding to current buffer.
  9569. If in a file, dired the current directory and move to file's line.
  9570. If in dired already, pop up a level and goto old directory's line.
  9571. In case the proper dired file line cannot be found, refresh the dired
  9572. buffer and try again.Fdisassemble
  9573. Print disassembled code for OBJECT in (optional) BUFFER.
  9574. OBJECT can be a symbol defined as a function, or a function itself
  9575. (a lambda expression or a compiled-function object).
  9576. If OBJECT is not already compiled, we compile it, but do not
  9577. redefine OBJECT if it is a symbol.Fmake-display-table
  9578. Return a new, empty display table.Fdisplay-table-slot
  9579. Return the value of the extra slot in DISPLAY-TABLE named SLOT.
  9580. SLOT may be a number from 0 to 5 inclusive, or a slot name (symbol).
  9581. Valid symbols are `truncation', `wrap', `escape', `control',
  9582. `selective-display', and `vertical-border'.Fset-display-table-slot
  9583. Set the value of the extra slot in DISPLAY-TABLE named SLOT to VALUE.
  9584. SLOT may be a number from 0 to 5 inclusive, or a name (symbol).
  9585. Valid symbols are `truncation', `wrap', `escape', `control',
  9586. `selective-display', and `vertical-border'.Fdescribe-display-table
  9587. Describe the display table DT in a help buffer.Fdescribe-current-display-table
  9588. Describe the display table in use in the selected window and buffer.Fstandard-display-8bit
  9589. Display characters in the range L to H literally.Fstandard-display-default
  9590. Display characters in the range L to H using the default notation.Fstandard-display-ascii
  9591. Display character C using printable string S.Fstandard-display-g1
  9592. Display character C as character SC in the g1 character set.
  9593. This function assumes that your terminal uses the SO/SI characters;
  9594. it is meaningless for an X frame.Fstandard-display-graphic
  9595. Display character C as character GC in graphics character set.
  9596. This function assumes VT100-compatible escapes; it is meaningless for an
  9597. X frame.Fstandard-display-underline
  9598. Display character C as character UC plus underlining.Fstandard-display-european
  9599. Toggle display of European characters encoded with ISO 8859.
  9600. When enabled, characters in the range of 160 to 255 display not
  9601. as octal escapes, but as accented characters.
  9602. With prefix argument, enable European character display iff arg is positive.Fdissociated-press
  9603. Dissociate the text of the current buffer.
  9604. Output goes in buffer named *Dissociation*,
  9605. which is redisplayed each time text is added to it.
  9606. Every so often the user must say whether to continue.
  9607. If ARG is positive, require ARG chars of continuity.
  9608. If ARG is negative, require -ARG words of continuity.
  9609. Default is 2.Fdocref-setup
  9610. Process docref cross-references in the current buffer.
  9611. See also \(f@docref-subst).Fdoctor
  9612. Switch to *doctor* buffer and start giving psychotherapy.Fdouble-mode
  9613. Toggle Double mode.
  9614. With prefix arg, turn Double mode on iff arg is positive.
  9615.  
  9616. When Double mode is on, some keys will insert different strings
  9617. when pressed twice.  See variable `double-map' for details.Fdunnet
  9618. Switch to *dungeon* buffer and start game.Feasy-menu-define
  9619. Define a menu bar submenu in maps MAPS, according to MENU.
  9620. The menu keymap is stored in symbol SYMBOL, both as its value
  9621. and as its function definition.   DOC is used as the doc string for SYMBOL.
  9622.  
  9623. The first element of MENU must be a string.  It is the menu bar item name.
  9624. The rest of the elements are menu items.
  9625.  
  9626. A menu item is usually a vector of three elements:  [NAME CALLBACK ENABLE]
  9627.  
  9628. NAME is a string--the menu item name.
  9629.  
  9630. CALLBACK is a command to run when the item is chosen,
  9631. or a list to evaluate when the item is chosen.
  9632.  
  9633. ENABLE is an expression; the item is enabled for selection
  9634. whenever this expression's value is non-nil.
  9635.  
  9636. Alternatively, a menu item may have the form: 
  9637.  
  9638.    [ NAME CALLBACK [ KEYWORD ARG ] ... ]
  9639.  
  9640. Where KEYWORD is one of the symbol defined below.
  9641.  
  9642.    :keys KEYS
  9643.  
  9644. KEYS is a string; a complex keyboard equivalent to this menu item.
  9645. This is normally not needed because keyboard equivalents are usually
  9646. computed automatically.
  9647.  
  9648.    :active ENABLE
  9649.  
  9650. ENABLE is an expression; the item is enabled for selection
  9651. whenever this expression's value is non-nil.
  9652.  
  9653.    :suffix NAME
  9654.  
  9655. NAME is a string; the name of an argument to CALLBACK.
  9656.  
  9657.    :style STYLE
  9658.    
  9659. STYLE is a symbol describing the type of menu item.  The following are
  9660. defined:  
  9661.  
  9662. toggle: A checkbox.  
  9663.         Currently just prepend the name with the string "Toggle ".
  9664. radio: A radio button. 
  9665. nil: An ordinary menu item.
  9666.  
  9667.    :selected SELECTED
  9668.  
  9669. SELECTED is an expression; the checkbox or radio button is selected
  9670. whenever this expression's value is non-nil.
  9671. Currently just disable radio buttons, no effect on checkboxes.
  9672.  
  9673. A menu item can be a string.  Then that string appears in the menu as
  9674. unselectable text.  A string consisting solely of hyphens is displayed
  9675. as a solid horizontal line.
  9676.  
  9677. A menu item can be a list.  It is treated as a submenu.
  9678. The first element should be the submenu name.  That's used as the
  9679. menu item in the top-level menu.  The cdr of the submenu list
  9680. is a list of menu items, as above.Felectric-buffer-list
  9681. Pops up a buffer describing the set of Emacs buffers.
  9682. Vaguely like ITS lunar select buffer; combining typeoutoid buffer
  9683. listing with menuoid buffer selection.
  9684.  
  9685. If the very next character typed is a space then the buffer list
  9686. window disappears.  Otherwise, one may move around in the buffer list
  9687. window, marking buffers to be selected, saved or deleted.
  9688.  
  9689. To exit and select a new buffer, type a space when the cursor is on
  9690. the appropriate line of the buffer-list window.  Other commands are
  9691. much like those of buffer-menu-mode.
  9692.  
  9693. Calls value of `electric-buffer-menu-mode-hook' on entry if non-nil.
  9694.  
  9695. \{electric-buffer-menu-mode-map}FElectric-command-history-redo-expression
  9696. Edit current history line in minibuffer and execute result.
  9697. With prefix arg NOCONFIRM, execute current line as-is without editing.Fdef-edebug-spec
  9698. Set the edebug-form-spec property of SYMBOL according to SPEC.
  9699. Both SYMBOL and SPEC are unevaluated. The SPEC can be 0, t, a symbol
  9700. (naming a function), or a list.Fedebug-eval-top-level-form
  9701. Evaluate a top level form, such as a defun or defmacro.
  9702. This is like `eval-defun', but the code is always instrumented for Edebug.
  9703. Print its name in the minibuffer and leave point where it is,
  9704. or if an error occurs, leave point after it with mark at the original point.Fediff-files
  9705. Run Ediff on a pair of files, FILE-A and FILE-B.Fediff-files3
  9706. Run Ediff on three files, FILE-A, FILE-B, and FILE-C.Fediff-buffers
  9707. Run Ediff on a pair of buffers, BUFFER-A and BUFFER-B.Fediff-buffers3
  9708. Run Ediff on three buffers, BUFFER-A, BUFFER-B, and BUFFER-C.Fediff-directories
  9709. Run Ediff on a pair of directories, DIR1 and DIR2, comparing files that have
  9710. the same name in both. The third argument, REGEXP, is a regular expression that
  9711. can be used to filter out certain file names.Fediff-directory-revisions
  9712. Run Ediff on a directory, DIR1, comparing its files with their revisions.
  9713. The second argument, REGEXP, is a regular expression that filters the file
  9714. names. Only the files that are under revision control are taken into account.Fediff-directories3
  9715. Run Ediff on three directories, DIR1, DIR2, and DIR3, comparing files that
  9716. have the same name in all three. The last argument, REGEXP, is a regular
  9717. expression that can be used to filter out certain file names.Fediff-merge-directories
  9718. Run Ediff on a pair of directories, DIR1 and DIR2, merging files that have
  9719. the same name in both. The third argument, REGEXP, is a regular expression that
  9720. can be used to filter out certain file names.Fediff-merge-directories-with-ancestor
  9721. Merge files in directories DIR1 and DIR2 using files in ANCESTOR-DIR as ancestors.
  9722. Ediff merges files that have identical names in DIR1, DIR2. If a pair of files
  9723. in DIR1 and DIR2 doesn't have an ancestor in ANCESTOR-DIR, Ediff will merge
  9724. without ancestor. The fourth argument, REGEXP, is a regular expression that
  9725. can be used to filter out certain file names.Fediff-merge-directory-revisions
  9726. Run Ediff on a directory, DIR1, merging its files with their revisions.
  9727. The second argument, REGEXP, is a regular expression that filters the file
  9728. names. Only the files that are under revision control are taken into account.Fediff-merge-directory-revisions-with-ancestor
  9729. Run Ediff on a directory, DIR1, merging its files with their revisions and ancestors.
  9730. The second argument, REGEXP, is a regular expression that filters the file
  9731. names. Only the files that are under revision control are taken into account.Fediff-windows-wordwise
  9732. Compare WIND-A and WIND-B, which are selected by clicking, wordwise.
  9733. With prefix argument, DUMB-MODE, or on a non-windowing display, works as
  9734. follows:
  9735. If WIND-A is nil, use selected window.
  9736. If WIND-B is nil, use window next to WIND-A.Fediff-windows-linewise
  9737. Compare WIND-A and WIND-B, which are selected by clicking, linewise.
  9738. With prefix argument, DUMB-MODE, or on a non-windowing display, works as
  9739. follows:
  9740. If WIND-A is nil, use selected window.
  9741. If WIND-B is nil, use window next to WIND-A.Fediff-regions-wordwise
  9742. Run Ediff on a pair of regions in two different buffers.
  9743. Regions (i.e., point and mark) are assumed to be set in advance.
  9744. This function is effective only for relatively small regions, up to 200
  9745. lines. For large regions, use `ediff-regions-linewise'.Fediff-regions-linewise
  9746. Run Ediff on a pair of regions in two different buffers.
  9747. Regions (i.e., point and mark) are assumed to be set in advance.
  9748. Each region is enlarged to contain full lines.
  9749. This function is effective for large regions, over 100-200
  9750. lines. For small regions, use `ediff-regions-wordwise'.Fediff-merge-files
  9751. Merge two files without ancestor.Fediff-merge-files-with-ancestor
  9752. Merge two files with ancestor.Fediff-merge-buffers
  9753. Merge buffers without ancestor.Fediff-merge-buffers-with-ancestor
  9754. Merge buffers with ancestor.Fediff-merge-revisions
  9755. Run Ediff by merging two revisions of a file.
  9756. The file is the optional FILE argument or the file visited by the current
  9757. buffer.Fediff-merge-revisions-with-ancestor
  9758. Run Ediff by merging two revisions of a file with a common ancestor.
  9759. The file is the the optional FILE argument or the file visited by the current
  9760. buffer.Frun-ediff-from-cvs-buffer
  9761. Run Ediff-merge on appropriate revisions of the selected file.
  9762. First run after `M-x cvs-update'. Then place the cursor on a lide describing a
  9763. file and then run `run-ediff-from-cvs-buffer'.Fediff-patch-file
  9764. Run Ediff by patching SOURCE-FILENAME.Fediff-patch-buffer
  9765. Run Ediff by patching BUFFER-NAME.Fediff-revision
  9766. Run Ediff by comparing versions of a file.
  9767. The file is an optional FILE argument or the file visited by the current
  9768. buffer. Use `vc.el' or `rcs.el' depending on `ediff-version-control-package'.Fediff-version
  9769. Return string describing the version of Ediff.
  9770. When called interactively, displays the version.Fediff-documentation
  9771. Display Ediff's manual.Fediff-show-registry
  9772. Display Ediff's registry.Vedmacro-eight-bits
  9773. *Non-nil if edit-kbd-macro should leave 8-bit characters intact.
  9774. Default nil means to write characters above \177 in octal notation.Fedit-kbd-macro
  9775. Edit a keyboard macro.
  9776. At the prompt, type any key sequence which is bound to a keyboard macro.
  9777. Or, type `C-x e' or RET to edit the last keyboard macro, `C-h l' to edit
  9778. the last 100 keystrokes as a keyboard macro, or `M-x' to edit a macro by
  9779. its command name.
  9780. With a prefix argument, format the macro in a more concise way.Fedit-last-kbd-macro
  9781. Edit the most recently defined keyboard macro.Fedit-named-kbd-macro
  9782. Edit a keyboard macro which has been given a name by `name-last-kbd-macro'.Fread-kbd-macro
  9783. Read the region as a keyboard macro definition.
  9784. The region is interpreted as spelled-out keystrokes, e.g., "M-x abc RET".
  9785. See documentation for `edmacro-mode' for details.
  9786. Leading/trailing "C-x (" and "C-x )" in the text are allowed and ignored.
  9787. The resulting macro is installed as the "current" keyboard macro.
  9788.  
  9789. In Lisp, may also be called with a single STRING argument in which case
  9790. the result is returned rather than being installed as the current macro.
  9791. The result will be a string if possible, otherwise an event vector.
  9792. Second argument NEED-VECTOR means to return an event vector always.Fformat-kbd-macro
  9793. Return the keyboard macro MACRO as a human-readable string.
  9794. This string is suitable for passing to `read-kbd-macro'.
  9795. Second argument VERBOSE means to put one command per line with comments.
  9796. If VERBOSE is `1', put everything on one line.  If VERBOSE is omitted
  9797. or nil, use a compact 80-column format.Finsert-kbd-macro
  9798. Insert in buffer the definition of kbd macro NAME, as Lisp code.
  9799. Optional second arg KEYS means also record the keys it is on
  9800. (this is the prefix argument, when calling interactively).
  9801.  
  9802. This Lisp code will, when executed, define the kbd macro with the same
  9803. definition it has now.  If you say to record the keys, the Lisp code
  9804. will also rebind those keys to the macro.  Only global key bindings
  9805. are recorded since executing this Lisp code always makes global
  9806. bindings.
  9807.  
  9808. To save a kbd macro, visit a file of Lisp code such as your `~/.emacs',
  9809. use this command, and then save the file.Fedt-emulation-on
  9810. Turn on EDT Emulation.Fwith-electric-help
  9811. Pop up an "electric" help buffer.
  9812. The arguments are THUNK &optional BUFFER NOERASE MINHEIGHT.
  9813. THUNK is a function of no arguments which is called to initialize the
  9814. contents of BUFFER.  BUFFER defaults to `*Help*'.  BUFFER will be
  9815. erased before THUNK is called unless NOERASE is non-nil.  THUNK will
  9816. be called while BUFFER is current and with `standard-output' bound to
  9817. the buffer specified by BUFFER.
  9818.  
  9819. If THUNK returns nil, we display BUFFER starting at the top, and
  9820. shrink the window to fit.  If THUNK returns non-nil, we don't do those things.
  9821.  
  9822. After THUNK has been called, this function "electrically" pops up a window
  9823. in which BUFFER is displayed and allows the user to scroll through that buffer
  9824. in electric-help-mode. The window's height will be at least MINHEIGHT if
  9825. this value is non-nil.
  9826.  
  9827. If THUNK returns nil, we display BUFFER starting at the top, and
  9828. shrink the window to fit.  If THUNK returns non-nil, we don't do those
  9829. things.
  9830.  
  9831. When the user exits (with `electric-help-exit', or otherwise) the help
  9832. buffer's window disappears (i.e., we use `save-window-excursion')
  9833. BUFFER is put into `default-major-mode' (or `fundamental-mode') when we exit.Felp-instrument-function
  9834. Instrument FUNSYM for profiling.
  9835. FUNSYM must be a symbol of a defined function.Felp-restore-function
  9836. Restore an instrumented function to its original definition.
  9837. Argument FUNSYM is the symbol of a defined function.Felp-instrument-list
  9838. Instrument for profiling, all functions in `elp-function-list'.
  9839. Use optional LIST if provided instead.Felp-instrument-package
  9840. Instrument for profiling, all functions which start with PREFIX.
  9841. For example, to instrument all ELP functions, do the following:
  9842.  
  9843.     \[elp-instrument-package] RET elp- RETFelp-results
  9844. Display current profiling results.
  9845. If `elp-reset-after-results' is non-nil, then current profiling
  9846. information for all instrumented functions are reset after results are
  9847. displayed.Felp-submit-bug-report
  9848. Submit via mail, a bug report on elp.Freport-emacs-bug
  9849. Report a bug in GNU Emacs.
  9850. Prompts for bug subject.  Leaves you in a mail buffer.Femerge-files
  9851. Run Emerge on two files.Femerge-files-with-ancestor
  9852. Run Emerge on two files, giving another file as the ancestor.Femerge-buffers
  9853. Run Emerge on two buffers.Femerge-buffers-with-ancestor
  9854. Run Emerge on two buffers, giving another buffer as the ancestor.Femerge-revisions
  9855. Emerge two RCS revisions of a file.Femerge-revisions-with-ancestor
  9856. Emerge two RCS revisions of a file, with another revision as ancestor.Fenriched-mode
  9857. Minor mode for editing text/enriched files.
  9858. These are files with embedded formatting information in the MIME standard
  9859. text/enriched format.
  9860. Turning the mode on runs `enriched-mode-hook'.
  9861.  
  9862. More information about Enriched mode is available in the file 
  9863. etc/enriched.doc  in the Emacs distribution directory.
  9864.  
  9865. Commands:
  9866.  
  9867. \<enriched-mode-map>\{enriched-mode-map}Fsetenv
  9868. Set the value of the environment variable named VARIABLE to VALUE.
  9869. VARIABLE should be a string.  VALUE is optional; if not provided or is
  9870. `nil', the environment variable VARIABLE will be removed.
  9871.  
  9872. Interactively, a prefix argument means to unset the variable.
  9873. Interactively, the current value (if any) of the variable
  9874. appears at the front of the history list when you type in the new value.
  9875.  
  9876. This function works by modifying `process-environment'.Vtags-file-name
  9877. *File name of tags table.
  9878. To switch to a new tags table, setting this variable is sufficient.
  9879. If you set this variable, do not also set `tags-table-list'.
  9880. Use the `etags' program to make a tags table file.Vtags-table-list
  9881. *List of file names of tags tables to search.
  9882. An element that is a directory means the file "TAGS" in that directory.
  9883. To switch to a new list of tags tables, setting this variable is sufficient.
  9884. If you set this variable, do not also set `tags-file-name'.
  9885. Use the `etags' program to make a tags table file.Vtags-add-tables
  9886. *Control whether to add a new tags table to the current list.
  9887. t means do; nil means don't (always start a new list).
  9888. Any other value means ask the user whether to add a new tags table
  9889. to the current list (as opposed to starting a new list).Vfind-tag-hook
  9890. *Hook to be run by \[find-tag] after finding a tag.  See `run-hooks'.
  9891. The value in the buffer in which \[find-tag] is done is used,
  9892. not the value in the buffer \[find-tag] goes to.Vfind-tag-default-function
  9893. *A function of no arguments used by \[find-tag] to pick a default tag.
  9894. If nil, and the symbol that is the value of `major-mode'
  9895. has a `find-tag-default-function' property (see `put'), that is used.
  9896. Otherwise, `find-tag-default' is used.Fvisit-tags-table
  9897. Tell tags commands to use tags table file FILE.
  9898. FILE should be the name of a file created with the `etags' program.
  9899. A directory name is ok too; it means file TAGS in that directory.
  9900.  
  9901. Normally \[visit-tags-table] sets the global value of `tags-file-name'.
  9902. With a prefix arg, set the buffer-local value instead.
  9903. When you find a tag with \[find-tag], the buffer it finds the tag
  9904. in is given a local value of this variable which is the name of the tags
  9905. file the tag was in.Ftags-table-files
  9906. Return a list of files in the current tags table.
  9907. Assumes the tags table is the current buffer.  The file names are returned
  9908. as they appeared in the `etags' command that created the table, usually
  9909. without directory names.Ffind-tag-noselect
  9910. Find tag (in current tags table) whose name contains TAGNAME.
  9911. Returns the buffer containing the tag's definition and moves its point there,
  9912. but does not select the buffer.
  9913. The default for TAGNAME is the expression in the buffer near point.
  9914.  
  9915. If second arg NEXT-P is t (interactively, with prefix arg), search for
  9916. another tag that matches the last tagname or regexp used.  When there are
  9917. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  9918. is the atom `-' (interactively, with prefix arg that is a negative number
  9919. or just \[negative-argument]), pop back to the previous tag gone to.
  9920.  
  9921. If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
  9922.  
  9923. See documentation of variable `tags-file-name'.Ffind-tag
  9924. Find tag (in current tags table) whose name contains TAGNAME.
  9925. Select the buffer containing the tag's definition, and move point there.
  9926. The default for TAGNAME is the expression in the buffer around or before point.
  9927.  
  9928. If second arg NEXT-P is t (interactively, with prefix arg), search for
  9929. another tag that matches the last tagname or regexp used.  When there are
  9930. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  9931. is the atom `-' (interactively, with prefix arg that is a negative number
  9932. or just \[negative-argument]), pop back to the previous tag gone to.
  9933.  
  9934. See documentation of variable `tags-file-name'.Ffind-tag-other-window
  9935. Find tag (in current tags table) whose name contains TAGNAME.
  9936. Select the buffer containing the tag's definition in another window, and
  9937. move point there.  The default for TAGNAME is the expression in the buffer
  9938. around or before point.
  9939.  
  9940. If second arg NEXT-P is t (interactively, with prefix arg), search for
  9941. another tag that matches the last tagname or regexp used.  When there are
  9942. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  9943. is negative (interactively, with prefix arg that is a negative number or
  9944. just \[negative-argument]), pop back to the previous tag gone to.
  9945.  
  9946. See documentation of variable `tags-file-name'.Ffind-tag-other-frame
  9947. Find tag (in current tags table) whose name contains TAGNAME.
  9948. Select the buffer containing the tag's definition in another frame, and
  9949. move point there.  The default for TAGNAME is the expression in the buffer
  9950. around or before point.
  9951.  
  9952. If second arg NEXT-P is t (interactively, with prefix arg), search for
  9953. another tag that matches the last tagname or regexp used.  When there are
  9954. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  9955. is negative (interactively, with prefix arg that is a negative number or
  9956. just \[negative-argument]), pop back to the previous tag gone to.
  9957.  
  9958. See documentation of variable `tags-file-name'.Ffind-tag-regexp
  9959. Find tag (in current tags table) whose name matches REGEXP.
  9960. Select the buffer containing the tag's definition and move point there.
  9961.  
  9962. If second arg NEXT-P is t (interactively, with prefix arg), search for
  9963. another tag that matches the last tagname or regexp used.  When there are
  9964. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  9965. is negative (interactively, with prefix arg that is a negative number or
  9966. just \[negative-argument]), pop back to the previous tag gone to.
  9967.  
  9968. If third arg OTHER-WINDOW is non-nil, select the buffer in another window.
  9969.  
  9970. See documentation of variable `tags-file-name'.Fnext-file
  9971. Select next file among files in current tags table.
  9972.  
  9973. A first argument of t (prefix arg, if interactive) initializes to the
  9974. beginning of the list of files in the tags table.  If the argument is
  9975. neither nil nor t, it is evalled to initialize the list of files.
  9976.  
  9977. Non-nil second argument NOVISIT means use a temporary buffer
  9978.  to save time and avoid uninteresting warnings.
  9979.  
  9980. Value is nil if the file was already visited;
  9981. if the file was newly read in, the value is the filename.Ftags-loop-continue
  9982. Continue last \[tags-search] or \[tags-query-replace] command.
  9983. Used noninteractively with non-nil argument to begin such a command (the
  9984. argument is passed to `next-file', which see).
  9985.  
  9986. Two variables control the processing we do on each file: the value of
  9987. `tags-loop-scan' is a form to be executed on each file to see if it is
  9988. interesting (it returns non-nil if so) and `tags-loop-operate' is a form to
  9989. evaluate to operate on an interesting file.  If the latter evaluates to
  9990. nil, we exit; otherwise we scan the next file.Ftags-search
  9991. Search through all files listed in tags table for match for REGEXP.
  9992. Stops when a match is found.
  9993. To continue searching for next match, use command \[tags-loop-continue].
  9994.  
  9995. See documentation of variable `tags-file-name'.Ftags-query-replace
  9996. Query-replace-regexp FROM with TO through all files listed in tags table.
  9997. Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
  9998. If you exit (\[keyboard-quit] or ESC), you can resume the query-replace
  9999. with the command \[tags-loop-continue].
  10000.  
  10001. See documentation of variable `tags-file-name'.Flist-tags
  10002. Display list of tags in file FILE.
  10003. This searches only the first table in the list, and no included tables.
  10004. FILE should be as it appeared in the `etags' command, usually without a
  10005. directory specification.Ftags-apropos
  10006. Display list of all tags in tags table REGEXP matches.Fselect-tags-table
  10007. Select a tags table file from a menu of those you have already used.
  10008. The list of tags tables to select from is stored in `tags-table-set-list';
  10009. see the doc of that variable if you want to add names to the list.Fcomplete-tag
  10010. Perform tags completion on the text around point.
  10011. Completes to the set of names listed in the current tags table.
  10012. The string to complete is chosen in the same way as the default
  10013. for \[find-tag] (which see).Fexecutable-set-magic
  10014. Set this buffer's interpreter to INTERPRETER with optional ARGUMENT.
  10015. The variables `executable-magicless-file-regexp', `executable-prefix',
  10016. `executable-insert', `executable-query' and `executable-chmod' control
  10017. when and how magic numbers are inserted or replaced and scripts made
  10018. executable.Fexecutable-self-display
  10019. Turn a text file into a self-displaying Un*x command.
  10020. The magic number of such a command displays all lines but itself.Ff90-mode
  10021. Major mode for editing Fortran 90 code in free format.
  10022.  
  10023. \[f90-indent-new-line] corrects current indentation and creates new indented line.
  10024. \[f90-indent-line] indents the current line correctly. 
  10025. \[f90-indent-subprogram] indents the current subprogram. 
  10026.  
  10027. Type `? or `\[help-command] to display a list of built-in abbrevs for F90 keywords.
  10028.  
  10029. Key definitions:
  10030. \{f90-mode-map}
  10031.  
  10032. Variables controlling indentation style and extra features:
  10033.  
  10034.  f90-do-indent
  10035.     Extra indentation within do blocks.  (default 3)
  10036.  f90-if-indent
  10037.     Extra indentation within if/select case/where/forall blocks. (default 3)
  10038.  f90-type-indent
  10039.     Extra indentation within type/interface/block-data blocks.  (default 3)
  10040.  f90-program-indent
  10041.     Extra indentation within program/module/subroutine/function blocks.
  10042.       (default 2)
  10043.  f90-continuation-indent
  10044.     Extra indentation applied to continuation lines.  (default 5)
  10045.  f90-comment-region
  10046.     String inserted by \[f90-comment-region] at start of each line in 
  10047.     region.  (default "!!!$")
  10048.  f90-indented-comment-re
  10049.     Regexp determining the type of comment to be intended like code.
  10050.     (default "!")
  10051.  f90-directive-comment-re
  10052.     Regexp of comment-like directive like "!HPF\\$", not to be indented.
  10053.     (default "!hpf\\$")
  10054.  f90-break-delimiters
  10055.     Regexp holding list of delimiters at which lines may be broken.
  10056.     (default "[-+*/><=,% \t]")
  10057.  f90-break-before-delimiters
  10058.     Non-nil causes `f90-do-auto-fill' to break lines before delimiters.
  10059.     (default t)
  10060.  f90-beginning-ampersand 
  10061.     Automatic insertion of & at beginning of continuation lines. (default t)
  10062.  f90-smart-end 
  10063.     From an END statement, check and fill the end using matching block start.
  10064.     Allowed values are 'blink, 'no-blink, and nil, which determine
  10065.     whether to blink the matching beginning.) (default 'blink)
  10066.  f90-auto-keyword-case
  10067.     Automatic change of case of keywords. (default nil)
  10068.     The possibilities are 'downcase-word, 'upcase-word, 'capitalize-word.
  10069.  f90-leave-line-no
  10070.     Do not left-justify line numbers. (default nil)
  10071.  f90-startup-message
  10072.     Set to nil to inhibit message first time F90 mode is used. (default t)
  10073.  f90-keywords-re
  10074.     List of keywords used for highlighting/upcase-keywords etc.
  10075.  
  10076. Turning on F90 mode calls the value of the variable `f90-mode-hook'
  10077. with no args, if that value is non-nil.Vfacemenu-face-menu
  10078. Menu keymap for faces.Vfacemenu-foreground-menu
  10079. Menu keymap for foreground colors.Vfacemenu-background-menu
  10080. Menu keymap for background colorsVfacemenu-special-menu
  10081. Menu keymap for non-face text-properties.Vfacemenu-justification-menu
  10082. Submenu for text justification commands.Vfacemenu-indentation-menu
  10083. Submenu for indentation commands.Vfacemenu-menu
  10084. Facemenu top-level menu keymap.Ffacemenu-set-face
  10085. Add FACE to the region or next character typed.
  10086. It will be added to the top of the face list; any faces lower on the list that
  10087. will not show through at all will be removed.
  10088.  
  10089. Interactively, the face to be used is read with the minibuffer.
  10090.  
  10091. If the region is active and there is no prefix argument,
  10092. this command sets the region to the requested face.
  10093.  
  10094. Otherwise, this command specifies the face for the next character
  10095. inserted.  Moving point or switching buffers before
  10096. typing a character to insert cancels the specification.Ffacemenu-set-foreground
  10097. Set the foreground color of the region or next character typed.
  10098. The color is prompted for.  A face named `fg:color' is used (or created).
  10099. If the region is active, it will be set to the requested face.  If
  10100. it is inactive (even if mark-even-if-inactive is set) the next
  10101. character that is typed (via `self-insert-command') will be set to
  10102. the selected face.  Moving point or switching buffers before
  10103. typing a character cancels the request.Ffacemenu-set-background
  10104. Set the background color of the region or next character typed.
  10105. The color is prompted for.  A face named `bg:color' is used (or created).
  10106. If the region is active, it will be set to the requested face.  If
  10107. it is inactive (even if mark-even-if-inactive is set) the next
  10108. character that is typed (via `self-insert-command') will be set to
  10109. the selected face.  Moving point or switching buffers before
  10110. typing a character cancels the request.Ffacemenu-set-face-from-menu
  10111. Set the face of the region or next character typed.
  10112. This function is designed to be called from a menu; the face to use
  10113. is the menu item's name.
  10114.  
  10115. If the region is active and there is no prefix argument,
  10116. this command sets the region to the requested face.
  10117.  
  10118. Otherwise, this command specifies the face for the next character
  10119. inserted.  Moving point or switching buffers before
  10120. typing a character to insert cancels the specification.Ffacemenu-set-invisible
  10121. Make the region invisible.
  10122. This sets the `invisible' text property; it can be undone with
  10123. `facemenu-remove-special'.Ffacemenu-set-intangible
  10124. Make the region intangible: disallow moving into it.
  10125. This sets the `intangible' text property; it can be undone with
  10126. `facemenu-remove-special'.Ffacemenu-set-read-only
  10127. Make the region unmodifiable.
  10128. This sets the `read-only' text property; it can be undone with
  10129. `facemenu-remove-special'.Ffacemenu-remove-props
  10130. Remove all text properties that facemenu added to region.Ffacemenu-remove-all
  10131. Remove all text properties from the region.Ffacemenu-remove-special
  10132. Remove all the "special" text properties from the region.
  10133. These special properties include `invisible', `intangible' and `read-only'.Flist-text-properties-at
  10134. Pop up a buffer listing text-properties at LOCATION.Ffacemenu-read-color
  10135. Read a color using the minibuffer.Flist-colors-display
  10136. Display names of defined colors, and show what they look like.
  10137. If the optional argument LIST is non-nil, it should be a list of
  10138. colors to display.  Otherwise, this command computes a list
  10139. of colors that the current display can handle.Ffast-lock-mode
  10140. Toggle Fast Lock mode.
  10141. With arg, turn Fast Lock mode on if and only if arg is positive and the buffer
  10142. is associated with a file.  Enable it automatically in your `~/.emacs' by:
  10143.  
  10144.  (setq font-lock-support-mode 'fast-lock-mode)
  10145.  
  10146. If Fast Lock mode is enabled, and the current buffer does not contain any text
  10147. properties, any associated Font Lock cache is used if its timestamp matches the
  10148. buffer's file, and its `font-lock-keywords' match those that you are using.
  10149.  
  10150. Font Lock caches may be saved:
  10151.  - When you save the file's buffer.
  10152.  - When you kill an unmodified file's buffer.
  10153.  - When you exit Emacs, for all unmodified or saved buffers.
  10154. Depending on the value of `fast-lock-save-events'.
  10155. See also the commands `fast-lock-read-cache' and `fast-lock-save-cache'.
  10156.  
  10157. Use \[font-lock-fontify-buffer] to fontify the buffer if the cache is bad.
  10158.  
  10159. Various methods of control are provided for the Font Lock cache.  In general,
  10160. see variable `fast-lock-cache-directories' and function `fast-lock-cache-name'.
  10161. For saving, see variables `fast-lock-minimum-size', `fast-lock-save-events',
  10162. `fast-lock-save-others' and `fast-lock-save-faces'.
  10163.  
  10164. Use \[fast-lock-submit-bug-report] to send bug reports or feedback.Fturn-on-fast-lock
  10165. Unconditionally turn on Fast Lock mode.Fffap-next
  10166. Search buffer for next file or url, and run ffap.
  10167. Optional argument BACK says to search backwards.
  10168. Optional argument WRAP says to try wrapping around if necessary.
  10169. Interactively: use a single prefix to search backwards,
  10170. double prefix to wrap forward, triple to wrap backwards.
  10171. Actual search is done by `ffap-next-guess'.Ffind-file-at-point
  10172. Find FILENAME (or url), guessing default from text around point.
  10173. If `ffap-dired-wildcards' is set, wildcard patterns are passed to dired.
  10174. See also the functions `ffap-file-at-point', `ffap-url-at-point'.
  10175. With a prefix, this command behaves *exactly* like `ffap-file-finder'.
  10176. If `ffap-require-prefix' is set, the prefix meaning is reversed.
  10177.  
  10178. See <ftp://ftp.mathcs.emory.edu/pub/mic/emacs/> for latest version.Fffap-menu
  10179. Put up a menu of files and urls mentioned in this buffer.
  10180. Then set mark, jump to choice, and try to fetch it.  The menu is
  10181. cached in `ffap-menu-alist', and rebuilt by `ffap-menu-rescan'.
  10182. The optional RESCAN argument (a prefix, interactively) forces
  10183. a rebuild.  Searches with `ffap-menu-regexp'.Vfind-ls-option
  10184. *Description of the option to `find' to produce an `ls -l'-type listing.
  10185. This is a cons of two strings (FIND-OPTION . LS-SWITCHES).  FIND-OPTION
  10186. gives the option (or options) to `find' that produce the desired output.
  10187. LS-SWITCHES is a list of `ls' switches to tell dired how to parse the output.Vfind-grep-options
  10188. *Option to grep to be as silent as possible.
  10189. On Berkeley systems, this is `-s'; on Posix, and with GNU grep, `-q' does it.
  10190. On other systems, the closest you can come is to use `-l'.Ffind-dired
  10191. Run `find' and go into dired-mode on a buffer of the output.
  10192. The command run (after changing into DIR) is
  10193.  
  10194.     find . \( ARGS \) -lsFfind-name-dired
  10195. Search DIR recursively for files matching the globbing pattern PATTERN,
  10196. and run dired on those files.
  10197. PATTERN is a shell wildcard (not an Emacs regexp) and need not be quoted.
  10198. The command run (after changing into DIR) is
  10199.  
  10200.     find . -name 'PATTERN' -lsFfind-grep-dired
  10201. Find files in DIR containing a regexp ARG and start Dired on output.
  10202. The command run (after changing into DIR) is
  10203.  
  10204.     find . -exec grep -s ARG {} \; -ls
  10205.  
  10206. Thus ARG can also contain additional grep options.Fff-get-other-file
  10207. Find the header or source file corresponding to this file.
  10208. See also the documentation for `ff-find-other-file;.
  10209.  
  10210. If optional IN-OTHER-WINDOW is non-nil, find the file in another window.Fff-find-other-file
  10211. Find the header or source file corresponding to this file.
  10212. Being on a `#include' line pulls in that file.
  10213.  
  10214. If optional IN-OTHER-WINDOW is non-nil, find the file in the other window.
  10215. If optional IGNORE-INCLUDE is non-nil, ignore being on `#include' lines.
  10216.  
  10217. Variables of interest include:
  10218.  
  10219.  - ff-case-fold-search
  10220.    Non-nil means ignore cases in matches (see case-fold-search).
  10221.    If you have extensions in different cases, you will want this to be nil.
  10222.  
  10223.  - ff-always-in-other-window
  10224.    If non-nil, always open the other file in another window, unless an
  10225.    argument is given to ff-find-other-file.
  10226.  
  10227.  - ff-ignore-include
  10228.    If non-nil, ignores #include lines.
  10229.  
  10230.  - ff-always-try-to-create
  10231.    If non-nil, always attempt to create the other file if it was not found.
  10232.  
  10233.  - ff-quiet-mode
  10234.    If non-nil, traces which directories are being searched.
  10235.  
  10236.  - ff-special-constructs
  10237.    A list of regular expressions specifying how to recognise special
  10238.    constructs such as include files etc, and an associated method for
  10239.    extracting the filename from that construct.
  10240.  
  10241.  - ff-other-file-alist
  10242.    Alist of extensions to find given the current file's extension.
  10243.  
  10244.  - ff-search-directories
  10245.    List of directories searched through with each extension specified in
  10246.    ff-other-file-alist that matches this file's extension.
  10247.  
  10248.  - ff-pre-find-hooks
  10249.    List of functions to be called before the search for the file starts.
  10250.  
  10251.  - ff-pre-load-hooks
  10252.    List of functions to be called before the other file is loaded.
  10253.  
  10254.  - ff-post-load-hooks
  10255.    List of functions to be called after the other file is loaded.
  10256.  
  10257.  - ff-not-found-hooks
  10258.    List of functions to be called if the other file could not be found.
  10259.  
  10260.  - ff-file-created-hooks
  10261.    List of functions to be called if the other file has been created.Fenable-flow-control
  10262. Toggle flow control handling.
  10263. When handling is enabled, user can type C-s as C-\, and C-q as C-^.
  10264. With arg, enable flow control mode if arg is positive, otherwise disable.Fenable-flow-control-on
  10265. Enable flow control if using one of a specified set of terminal types.
  10266. Use `(enable-flow-control-on "vt100" "h19")' to enable flow control
  10267. on VT-100 and H19 terminals.  When flow control is enabled,
  10268. you must type C-\ to get the effect of a C-s, and type C-^
  10269. to get the effect of a C-q.Fturn-on-follow-mode
  10270. Turn on Follow mode. Please see the function `follow-mode'.Fturn-off-follow-mode
  10271. Turn off Follow mode. Please see the function `follow-mode'.Ffollow-mode
  10272. Minor mode which combines windows into one tall virtual window.
  10273.  
  10274. The feeling of a "virtual window" has been accomplished by the use
  10275. of two major techniques:
  10276.  
  10277. * The windows always displays adjacent sections of the buffer. 
  10278.   This means that whenever one window is moved, all the
  10279.   others will follow.  (Hence the name Follow Mode.)
  10280.  
  10281. * Should the point (cursor) end up outside a window, another 
  10282.   window displaying that point is selected, if possible.  This 
  10283.   makes it possible to walk between windows using normal cursor 
  10284.   movement commands.
  10285.  
  10286. Follow mode comes to its prime when used on a large screen and two
  10287. side-by-side window are used. The user can, with the help of Follow
  10288. mode, use two full-height windows as though they would have been
  10289. one. Imagine yourself editing a large function, or section of text,
  10290. and beeing able to use 144 lines instead of the normal 72... (your
  10291. mileage may vary).
  10292.  
  10293. To split one large window into two side-by-side windows, the commands
  10294. `\[split-window-horizontally]' or `M-x follow-delete-other-windows-and-split' can be used.
  10295.  
  10296. Only windows displayed in the same frame follow each-other.
  10297.  
  10298. If the variable `follow-intercept-processes' is non-nil, Follow mode
  10299. will listen to the output of processes and redisplay accordingly.
  10300. (This is the default.)
  10301.  
  10302. When Follow mode is switched on, the hook `follow-mode-hook'
  10303. is called.  When turned off, `follow-mode-off-hook' is called.
  10304.  
  10305. Keys specific to Follow mode:
  10306. \{follow-mode-map}Ffollow-delete-other-windows-and-split
  10307. Create two side by side windows and enter Follow Mode.
  10308.  
  10309. Execute this command to display as much as possible of the text
  10310. in the selected window.  All other windows, in the current 
  10311. frame, are deleted and the selected window is split in two
  10312. side-by-side windows. Follow Mode is activated, hence the 
  10313. two windows always will display two successive pages.
  10314. (If one window is moved, the other one will follow.)
  10315.  
  10316. If ARG is positive, the leftmost window is selected.  If it negative,
  10317. the rightmost is selected.  If ARG is nil, the leftmost window is
  10318. selected if the original window is the first one in the frame.
  10319.  
  10320. To bind this command to a hotkey, place the following line
  10321. in your `~/.emacs' file, replacing [f7] by your favourite key:
  10322.     (global-set-key [f7] 'follow-delete-other-windows-and-split)Vfont-lock-maximum-decoration
  10323. *Maximum decoration level for fontification.
  10324. If nil, use the default decoration (typically the minimum available).
  10325. If t, use the maximum decoration available.
  10326. If a number, use that level of decoration (or if not available the maximum).
  10327. If a list, each element should be a cons pair of the form (MAJOR-MODE . LEVEL),
  10328. where MAJOR-MODE is a symbol or t (meaning the default).  For example:
  10329.  ((c-mode . t) (c++-mode . 2) (t . 1))
  10330. means use the maximum decoration available for buffers in C mode, level 2
  10331. decoration for buffers in C++ mode, and level 1 decoration otherwise.Vfont-lock-maximum-size
  10332. *Maximum size of a buffer for buffer fontification.
  10333. Only buffers less than this can be fontified when Font Lock mode is turned on.
  10334. If nil, means size is irrelevant.
  10335. If a list, each element should be a cons pair of the form (MAJOR-MODE . SIZE),
  10336. where MAJOR-MODE is a symbol or t (meaning the default).  For example:
  10337.  ((c-mode . 256000) (c++-mode . 256000) (rmail-mode . 1048576))
  10338. means that the maximum size is 250K for buffers in C or C++ modes, one megabyte
  10339. for buffers in Rmail mode, and size is irrelevant otherwise.Vfont-lock-mode-hook
  10340. Function or functions to run on entry to Font Lock mode.Ffont-lock-mode
  10341. Toggle Font Lock mode.
  10342. With arg, turn Font Lock mode on if and only if arg is positive.
  10343.  
  10344. When Font Lock mode is enabled, text is fontified as you type it:
  10345.  
  10346.  - Comments are displayed in `font-lock-comment-face';
  10347.  - Strings are displayed in `font-lock-string-face';
  10348.  - Certain other expressions are displayed in other faces according to the
  10349.    value of the variable `font-lock-keywords'.
  10350.  
  10351. You can enable Font Lock mode in any major mode automatically by turning on in
  10352. the major mode's hook.  For example, put in your ~/.emacs:
  10353.  
  10354.  (add-hook 'c-mode-hook 'turn-on-font-lock)
  10355.  
  10356. Alternatively, you can use Global Font Lock mode to automagically turn on Font
  10357. Lock mode in buffers whose major mode supports it and whose major mode is one
  10358. of `font-lock-global-modes'.  For example, put in your ~/.emacs:
  10359.  
  10360.  (global-font-lock-mode t)
  10361.  
  10362. There are a number of support modes that may be used to speed up Font Lock mode
  10363. in various ways, specified via the variable `font-lock-support-mode'.  Where
  10364. major modes support different levels of fontification, you can use the variable
  10365. `font-lock-maximum-decoration' to specify which level you generally prefer.
  10366. When you turn Font Lock mode on/off the buffer is fontified/defontified, though
  10367. fontification occurs only if the buffer is less than `font-lock-maximum-size'.
  10368.  
  10369. For example, to specify that Font Lock mode use use Lazy Lock mode as a support
  10370. mode and use maximum levels of fontification, put in your ~/.emacs:
  10371.  
  10372.  (setq font-lock-support-mode 'lazy-lock-mode)
  10373.  (setq font-lock-maximum-decoration t)
  10374.  
  10375. To fontify a buffer, without turning on Font Lock mode and regardless of buffer
  10376. size, you can use \[font-lock-fontify-buffer].
  10377.  
  10378. To fontify a block (the function or paragraph containing point, or a number of
  10379. lines around point), perhaps because modification on the current line caused
  10380. syntactic change on other lines, you can use \[font-lock-fontify-block].
  10381.  
  10382. The default Font Lock mode faces and their attributes are defined in the
  10383. variable `font-lock-face-attributes', and Font Lock mode default settings in
  10384. the variable `font-lock-defaults-alist'.  You can set your own default settings
  10385. for some mode, by setting a buffer local value for `font-lock-defaults', via
  10386. its mode hook.Fturn-on-font-lock
  10387. Turn on Font Lock mode conditionally.
  10388. Turn on only if the terminal can display it.Vfont-lock-global-modes
  10389. *Modes for which Font Lock mode is automagically turned on.
  10390. Global Font Lock mode is controlled by the `global-font-lock-mode' command.
  10391. If nil, means no modes have Font Lock mode automatically turned on.
  10392. If t, all modes that support Font Lock mode have it automatically turned on.
  10393. If a list, it should be a list of `major-mode' symbol names for which Font Lock
  10394. mode should be automatically turned on.  The sense of the list is negated if it
  10395. begins with `not'.  For example:
  10396.  (c-mode c++-mode)
  10397. means that Font Lock mode is turned on for buffers in C and C++ modes only.Fglobal-font-lock-mode
  10398. Toggle Global Font Lock mode.
  10399. With prefix ARG, turn Global Font Lock mode on if and only if ARG is positive.
  10400. Displays a message saying whether the mode is on or off if MESSAGE is non-nil.
  10401. Returns the new status of Global Font Lock mode (non-nil means on).
  10402.  
  10403. When Global Font Lock mode is enabled, Font Lock mode is automagically
  10404. turned on in a buffer if its major mode is one of `font-lock-global-modes'.Vfont-lock-support-mode
  10405. *Support mode for Font Lock mode.
  10406. Support modes speed up Font Lock mode by being choosy about when fontification
  10407. occurs.  Known support modes are Fast Lock mode (symbol `fast-lock-mode') and
  10408. Lazy Lock mode (symbol `lazy-lock-mode').  See those modes for more info.
  10409. If nil, means support for Font Lock mode is never performed.
  10410. If a symbol, use that support mode.
  10411. If a list, each element should be of the form (MAJOR-MODE . SUPPORT-MODE),
  10412. where MAJOR-MODE is a symbol or t (meaning the default).  For example:
  10413.  ((c-mode . fast-lock-mode) (c++-mode . fast-lock-mode) (t . lazy-lock-mode))
  10414. means that Fast Lock mode is used to support Font Lock mode for buffers in C or
  10415. C++ modes, and Lazy Lock mode is used to support Font Lock mode otherwise.
  10416.  
  10417. The value of this variable is used when Font Lock mode is turned on.Ffont-lock-fontify-buffer
  10418. Fontify the current buffer the way `font-lock-mode' would.Fforms-mode
  10419. Major mode to visit files in a field-structured manner using a form.
  10420.  
  10421. Commands:                        Equivalent keys in read-only mode:
  10422.  TAB            forms-next-field          TAB
  10423.  \C-c TAB       forms-next-field          
  10424.  \C-c <         forms-first-record         <
  10425.  \C-c >         forms-last-record          >
  10426.  \C-c ?         describe-mode              ?
  10427.  \C-c \C-k      forms-delete-record
  10428.  \C-c \C-q      forms-toggle-read-only     q
  10429.  \C-c \C-o      forms-insert-record
  10430.  \C-c \C-l      forms-jump-record          l
  10431.  \C-c \C-n      forms-next-record          n
  10432.  \C-c \C-p      forms-prev-record          p
  10433.  \C-c \C-r      forms-search-reverse       r
  10434.  \C-c \C-s      forms-search-forward       s
  10435.  \C-c \C-x      forms-exit                 x
  10436. Fforms-find-file
  10437. Visit a file in Forms mode.Fforms-find-file-other-window
  10438. Visit a file in Forms mode in other window.Vfortran-tab-mode-default
  10439. *Default tabbing/carriage control style for empty files in Fortran mode.
  10440. A value of t specifies tab-digit style of continuation control.
  10441. A value of nil specifies that continuation lines are marked
  10442. with a character in column 6.Ffortran-mode
  10443. Major mode for editing Fortran code.
  10444. \[fortran-indent-line] indents the current Fortran line correctly.
  10445. DO statements must not share a common CONTINUE.
  10446.  
  10447. Type ;? or ;\[help-command] to display a list of built-in abbrevs for Fortran keywords.
  10448.  
  10449. Key definitions:
  10450. \{fortran-mode-map}
  10451.  
  10452. Variables controlling indentation style and extra features:
  10453.  
  10454.  comment-start
  10455.     Normally nil in Fortran mode.  If you want to use comments
  10456.     starting with `!', set this to the string "!".
  10457.  fortran-do-indent
  10458.     Extra indentation within do blocks.  (default 3)
  10459.  fortran-if-indent
  10460.     Extra indentation within if blocks.  (default 3)
  10461.  fortran-structure-indent
  10462.     Extra indentation within structure, union, map and interface blocks.
  10463.     (default 3)
  10464.  fortran-continuation-indent
  10465.     Extra indentation applied to continuation statements.  (default 5)
  10466.  fortran-comment-line-extra-indent
  10467.     Amount of extra indentation for text within full-line comments. (default 0)
  10468.  fortran-comment-indent-style
  10469.     nil    means don't change indentation of text in full-line comments,
  10470.     fixed  means indent that text at `fortran-comment-line-extra-indent' beyond
  10471.            the value of `fortran-minimum-statement-indent-fixed' (for fixed
  10472.            format continuation style) or `fortran-minimum-statement-indent-tab'
  10473.            (for TAB format continuation style).
  10474.     relative  means indent at `fortran-comment-line-extra-indent' beyond the
  10475.            indentation for a line of code.
  10476.     (default 'fixed)
  10477.  fortran-comment-indent-char
  10478.     Single-character string to be inserted instead of space for
  10479.     full-line comment indentation.  (default " ")
  10480.  fortran-minimum-statement-indent-fixed
  10481.     Minimum indentation for Fortran statements in fixed format mode. (def.6)
  10482.  fortran-minimum-statement-indent-tab
  10483.     Minimum indentation for Fortran statements in TAB format mode. (default 9)
  10484.  fortran-line-number-indent
  10485.     Maximum indentation for line numbers.  A line number will get
  10486.     less than this much indentation if necessary to avoid reaching
  10487.     column 5.  (default 1)
  10488.  fortran-check-all-num-for-matching-do
  10489.     Non-nil causes all numbered lines to be treated as possible "continue"
  10490.     statements.  (default nil)
  10491.  fortran-blink-matching-if
  10492.     Non-nil causes \[fortran-indent-line] on an ENDIF statement to blink on
  10493.     matching IF.  Also, from an ENDDO statement, blink on matching DO [WHILE]
  10494.     statement.  (default nil)
  10495.  fortran-continuation-string
  10496.     Single-character string to be inserted in column 5 of a continuation
  10497.     line.  (default "$")
  10498.  fortran-comment-region
  10499.     String inserted by \[fortran-comment-region] at start of each line in
  10500.     region.  (default "c$$$")
  10501.  fortran-electric-line-number
  10502.     Non-nil causes line number digits to be moved to the correct column
  10503.     as typed.  (default t)
  10504.  fortran-break-before-delimiters
  10505.     Non-nil causes `fortran-fill' breaks lines before delimiters.
  10506.     (default t)
  10507.  fortran-startup-message
  10508.     Set to nil to inhibit message first time Fortran mode is used.
  10509.  
  10510. Turning on Fortran mode calls the value of the variable `fortran-mode-hook'
  10511. with no args, if that value is non-nil.Fgnus-update-format
  10512. Update the format specification near point.Fgnus-add-configuration
  10513. Add the window configuration CONF to `gnus-buffer-configuration'.Fgnus-slave-no-server
  10514. Read network news as a slave, without connecting to local serverFgnus-no-server
  10515. Read network news.
  10516. If ARG is a positive number, Gnus will use that as the
  10517. startup level.    If ARG is nil, Gnus will be started at level 2.
  10518. If ARG is non-nil and not a positive number, Gnus will
  10519. prompt the user for the name of an NNTP server to use.
  10520. As opposed to `gnus', this command will not connect to the local server.Fgnus-slave
  10521. Read news as a slave.Fgnus-other-frame
  10522. Pop up a frame to read news.Fgnus
  10523. Read network news.
  10524. If ARG is non-nil and a positive number, Gnus will use that as the
  10525. startup level.    If ARG is non-nil and not a positive number, Gnus will
  10526. prompt the user for the name of an NNTP server to use.Fgnus-fetch-group
  10527. Start Gnus if necessary and enter GROUP.
  10528. Returns whether the fetching was successful or not.Fgnus-batch-score
  10529. Run batched scoring.
  10530. Usage: emacs -batch -l gnus -f gnus-batch-score <newsgroups> ...
  10531. Newsgroups is a list of strings in Bnews format.  If you want to score
  10532. the comp hierarchy, you'd say "comp.all".  If you would not like to
  10533. score the alt hierarchy, you'd say "!alt.all".Fgnus-jog-cache
  10534. Go through all groups and put the articles into the cache.Fgnus-cache-generate-active
  10535. Generate the cache active file.Fgnus-cache-generate-nov-databases
  10536. Generate NOV files recursively starting in DIR.Fgnus-batch-brew-soup
  10537. Brew a SOUP packet from groups mention on the command line.
  10538. Will use the remaining command line arguments as regular expressions
  10539. for matching on group names.
  10540.  
  10541. For instance, if you want to brew on all the nnml groups, as well as
  10542. groups with "emacs" in the name, you could say something like:
  10543.  
  10544. $ emacs -batch -f gnus-batch-brew-soup ^nnml ".*emacs.*"Fgomoku
  10545. Start a Gomoku game between you and Emacs.
  10546. If a game is in progress, this command allow you to resume it.
  10547. If optional arguments N and M are given, an N by M board is used.
  10548. If prefix arg is given for N, M is prompted for.
  10549.  
  10550. You and Emacs play in turn by marking a free square.  You mark it with X
  10551. and Emacs marks it with O. The winner is the first to get five contiguous
  10552. marks horizontally, vertically or in diagonal.
  10553.  
  10554. You play by moving the cursor over the square you choose and hitting
  10555. \<gomoku-mode-map>\[gomoku-human-plays].
  10556. Use \[describe-mode] for more info.Fgoto-address-at-mouse
  10557. Send to the e-mail address or load the URL clicked with the mouse.
  10558. Send mail to address at position of mouse click.  See documentation for
  10559. `goto-address-find-address-at-point'.  If no address is found
  10560. there, then load the URL at or before the position of the mouse click.Fgoto-address-at-point
  10561. Send to the e-mail address or load the URL at point.
  10562. Send mail to address at point.  See documentation for
  10563. `goto-address-find-address-at-point'.  If no address is found
  10564. there, then load the URL at or before point.Fgoto-address
  10565. Sets up goto-address functionality in the current buffer.
  10566. Allows user to use mouse/keyboard command to click to go to a URL
  10567. or to send e-mail.
  10568. By default, goto-address binds to mouse-2 and C-c RET.
  10569.  
  10570. Also fontifies the buffer appropriately (see `goto-address-fontify-p' and
  10571. `goto-address-highlight-p' for more information).Fgdb
  10572. Run gdb on program FILE in buffer *gud-FILE*.
  10573. The directory containing FILE becomes the initial working directory
  10574. and source-file directory for your debugger.Fsdb
  10575. Run sdb on program FILE in buffer *gud-FILE*.
  10576. The directory containing FILE becomes the initial working directory
  10577. and source-file directory for your debugger.Fdbx
  10578. Run dbx on program FILE in buffer *gud-FILE*.
  10579. The directory containing FILE becomes the initial working directory
  10580. and source-file directory for your debugger.Fxdb
  10581. Run xdb on program FILE in buffer *gud-FILE*.
  10582. The directory containing FILE becomes the initial working directory
  10583. and source-file directory for your debugger.
  10584.  
  10585. You can set the variable 'gud-xdb-directories' to a list of program source
  10586. directories if your program contains sources from more than one directory.Fperldb
  10587. Run perldb on program FILE in buffer *gud-FILE*.
  10588. The directory containing FILE becomes the initial working directory
  10589. and source-file directory for your debugger.Fhanoi
  10590. Towers of Hanoi diversion.  Argument is number of rings.Vthree-step-help
  10591. *Non-nil means give more info about Help command in three steps.
  10592. The three steps are simple prompt, prompt with all options,
  10593. and window listing and describing the options.
  10594. A value of nil means skip the middle step, so that
  10595. \[help-command] \[help-command] gives the window that lists the options.FHelper-describe-bindings
  10596. Describe local key bindings of current mode.FHelper-help
  10597. Provide help for current mode.Fhexl-mode
  10598. \<hexl-mode-map>
  10599. A major mode for editing binary files in hex dump format.
  10600.  
  10601. This function automatically converts a buffer into the hexl format
  10602. using the function `hexlify-buffer'.
  10603.  
  10604. Each line in the buffer has an "address" (displayed in hexadecimal)
  10605. representing the offset into the file that the characters on this line
  10606. are at and 16 characters from the file (displayed as hexadecimal
  10607. values grouped every 16 bits) and as their ASCII values.
  10608.  
  10609. If any of the characters (displayed as ASCII characters) are
  10610. unprintable (control or meta characters) they will be replaced as
  10611. periods.
  10612.  
  10613. If `hexl-mode' is invoked with an argument the buffer is assumed to be
  10614. in hexl format.
  10615.  
  10616. A sample format:
  10617.  
  10618.   HEX ADDR: 0001 0203 0405 0607 0809 0a0b 0c0d 0e0f     ASCII-TEXT
  10619.   --------  ---- ---- ---- ---- ---- ---- ---- ----  ----------------
  10620.   00000000: 5468 6973 2069 7320 6865 786c 2d6d 6f64  This is hexl-mod
  10621.   00000010: 652e 2020 4561 6368 206c 696e 6520 7265  e.  Each line re
  10622.   00000020: 7072 6573 656e 7473 2031 3620 6279 7465  presents 16 byte
  10623.   00000030: 7320 6173 2068 6578 6164 6563 696d 616c  s as hexadecimal
  10624.   00000040: 2041 5343 4949 0a61 6e64 2070 7269 6e74   ASCII.and print
  10625.   00000050: 6162 6c65 2041 5343 4949 2063 6861 7261  able ASCII chara
  10626.   00000060: 6374 6572 732e 2020 416e 7920 636f 6e74  cters.  Any cont
  10627.   00000070: 726f 6c20 6f72 206e 6f6e 2d41 5343 4949  rol or non-ASCII
  10628.   00000080: 2063 6861 7261 6374 6572 730a 6172 6520   characters.are 
  10629.   00000090: 6469 7370 6c61 7965 6420 6173 2070 6572  displayed as per
  10630.   000000a0: 696f 6473 2069 6e20 7468 6520 7072 696e  iods in the prin
  10631.   000000b0: 7461 626c 6520 6368 6172 6163 7465 7220  table character 
  10632.   000000c0: 7265 6769 6f6e 2e0a                      region..
  10633.  
  10634. Movement is as simple as movement in a normal emacs text buffer.  Most
  10635. cursor movement bindings are the same (ie. Use \[hexl-backward-char], \[hexl-forward-char], \[hexl-next-line], and \[hexl-previous-line]
  10636. to move the cursor left, right, down, and up).
  10637.  
  10638. Advanced cursor movement commands (ala \[hexl-beginning-of-line], \[hexl-end-of-line], \[hexl-beginning-of-buffer], and \[hexl-end-of-buffer]) are
  10639. also supported.
  10640.  
  10641. There are several ways to change text in hexl mode:
  10642.  
  10643. ASCII characters (character between space (0x20) and tilde (0x7E)) are
  10644. bound to self-insert so you can simply type the character and it will
  10645. insert itself (actually overstrike) into the buffer.
  10646.  
  10647. \[hexl-quoted-insert] followed by another keystroke allows you to insert the key even if
  10648. it isn't bound to self-insert.  An octal number can be supplied in place
  10649. of another key to insert the octal number's ASCII representation.
  10650.  
  10651. \[hexl-insert-hex-char] will insert a given hexadecimal value (if it is between 0 and 0xFF)
  10652. into the buffer at the current point.
  10653.  
  10654. \[hexl-insert-octal-char] will insert a given octal value (if it is between 0 and 0377)
  10655. into the buffer at the current point.
  10656.  
  10657. \[hexl-insert-decimal-char] will insert a given decimal value (if it is between 0 and 255)
  10658. into the buffer at the current point.
  10659.  
  10660. \[hexl-mode-exit] will exit hexl-mode.
  10661.  
  10662. Note: saving the file with any of the usual Emacs commands
  10663. will actually convert it back to binary format while saving.
  10664.  
  10665. You can use \[hexl-find-file] to visit a file in hexl-mode.
  10666.  
  10667. \[describe-bindings] for advanced commands.Fhexl-find-file
  10668. Edit file FILENAME in hexl-mode.
  10669. Switch to a buffer visiting file FILENAME, creating one in none exists.Fhexlify-buffer
  10670. Convert a binary buffer to hexl format.
  10671. This discards the buffer's undo information.Fhide-ifdef-mode
  10672. Toggle Hide-Ifdef mode.  This is a minor mode, albeit a large one.
  10673. With ARG, turn Hide-Ifdef mode on if arg is positive, off otherwise.
  10674. In Hide-Ifdef mode, code within #ifdef constructs that the C preprocessor
  10675. would eliminate may be hidden from view.  Several variables affect
  10676. how the hiding is done:
  10677.  
  10678. hide-ifdef-env
  10679.     An association list of defined and undefined symbols for the
  10680.     current buffer.  Initially, the global value of `hide-ifdef-env'
  10681.     is used.
  10682.  
  10683. hide-ifdef-define-alist
  10684.     An association list of defined symbol lists.  
  10685.         Use `hide-ifdef-set-define-alist' to save the current `hide-ifdef-env'
  10686.         and `hide-ifdef-use-define-alist' to set the current `hide-ifdef-env'
  10687.         from one of the lists in `hide-ifdef-define-alist'.
  10688.  
  10689. hide-ifdef-lines
  10690.     Set to non-nil to not show #if, #ifdef, #ifndef, #else, and
  10691.     #endif lines when hiding.
  10692.  
  10693. hide-ifdef-initially
  10694.     Indicates whether `hide-ifdefs' should be called when Hide-Ifdef mode
  10695.     is activated.
  10696.  
  10697. hide-ifdef-read-only
  10698.     Set to non-nil if you want to make buffers read only while hiding.
  10699.     After `show-ifdefs', read-only status is restored to previous value.
  10700.  
  10701. \{hide-ifdef-mode-map}Vhide-ifdef-initially
  10702. *Non-nil means call `hide-ifdefs' when Hide-Ifdef mode is first activated.Vhide-ifdef-read-only
  10703. *Set to non-nil if you want buffer to be read-only while hiding text.Vhide-ifdef-lines
  10704. *Non-nil means hide the #ifX, #else, and #endif lines.Fhs-hide-all
  10705. Hides all top-level blocks, displaying only first and last lines.
  10706. It moves point to the beginning of the line, and it runs the normal hook
  10707. `hs-hide-hook'.  See documentation for `run-hooks'.Fhs-hide-block
  10708. Selects a block and hides it.  With prefix arg, reposition at end.
  10709. Block is defined as a sexp for lispish modes, mode-specific otherwise.
  10710. Comments are blocks, too.  Upon completion, point is at repositioned and
  10711. the normal hook `hs-hide-hook' is run.  See documentation for `run-hooks'.Fhs-minor-mode
  10712. Toggle hideshow minor mode.
  10713. With ARG, turn hideshow minor mode on if ARG is positive, off otherwise.
  10714. When hideshow minor mode is on, the menu bar is augmented with hideshow
  10715. commands and the hideshow commands are enabled.  The variables
  10716. `selective-display' and `selective-display-ellipses' are set to t.
  10717. Last, the normal hook `hs-minor-mode-hook' is run; see the doc for `run-hooks'.
  10718.  
  10719. Turning hideshow minor mode off reverts the menu bar and the
  10720. variables to default values and disables the hideshow commands.Vhippie-expand-try-functions-list
  10721. The list of expansion functions tried in order by `hippie-expand'.
  10722. To change the behavior of `hippie-expand', remove, change the order of,
  10723. or insert functions in this list.Vhippie-expand-verbose
  10724. *Non-nil makes `hippie-expand' output which function it is trying.Vhippie-expand-max-buffers
  10725. *The maximum number of buffers (apart from the current) searched.
  10726. If nil, all buffers are searched.Vhippie-expand-ignore-buffers
  10727. *A list specifying which buffers not to search (if not current).
  10728. Can contain both regexps matching buffer names (as strings) and major modes
  10729. (as atoms)Fhippie-expand
  10730. Try to expand text before point, using multiple methods.
  10731. The expansion functions in `hippie-expand-try-functions-list' are
  10732. tried in order, until a possible expansion is found.  Repeated
  10733. application of `hippie-expand' inserts successively possible
  10734. expansions.  
  10735. With a positive numeric argument, jumps directly to the ARG next
  10736. function in this list.  With a negative argument or just \[universal-argument], 
  10737. undoes the expansion.Fmake-hippie-expand-function
  10738. Construct a function similar to `hippie-expand'.
  10739. Make it use the expansion functions in TRY-LIST.  An optional second
  10740. argument VERBOSE non-nil makes the function verbose.Ficomplete-mode
  10741. Activate incremental minibuffer completion for this emacs session,
  10742. or deactivate with negative prefix arg.Ficomplete-minibuffer-setup
  10743. Run in minibuffer on activation to establish incremental completion.
  10744. Usually run by inclusion in `minibuffer-setup-hook'.Ficon-mode
  10745. Major mode for editing Icon code.
  10746. Expression and list commands understand all Icon brackets.
  10747. Tab indents for Icon code.
  10748. Paragraphs are separated by blank lines only.
  10749. Delete converts tabs to spaces as it moves back.
  10750. \{icon-mode-map}
  10751. Variables controlling indentation style:
  10752.  icon-tab-always-indent
  10753.     Non-nil means TAB in Icon mode should always reindent the current line,
  10754.     regardless of where in the line point is when the TAB command is used.
  10755.  icon-auto-newline
  10756.     Non-nil means automatically newline before and after braces
  10757.     inserted in Icon code.
  10758.  icon-indent-level
  10759.     Indentation of Icon statements within surrounding block.
  10760.     The surrounding block's indentation is the indentation
  10761.     of the line on which the open-brace appears.
  10762.  icon-continued-statement-offset
  10763.     Extra indentation given to a substatement, such as the
  10764.     then-clause of an if or body of a while.
  10765.  icon-continued-brace-offset
  10766.     Extra indentation given to a brace that starts a substatement.
  10767.     This is in addition to `icon-continued-statement-offset'.
  10768.  icon-brace-offset
  10769.     Extra indentation for line if it starts with an open brace.
  10770.  icon-brace-imaginary-offset
  10771.     An open brace following other text is treated as if it were
  10772.     this far to the right of the start of its line.
  10773.  
  10774. Turning on Icon mode calls the value of the variable `icon-mode-hook'
  10775. with no args, if that value is non-nil.Fielm
  10776. Interactively evaluate Emacs Lisp expressions.
  10777. Switches to the buffer `*ielm*', or creates it if it does not exist.Vimenu-generic-expression
  10778. The regex pattern to use for creating a buffer index.
  10779.  
  10780. If non-nil this pattern is passed to `imenu-create-index-with-pattern'
  10781. to create a buffer index.
  10782.  
  10783. It is an alist with elements that look like this: (MENU-TITLE
  10784. REGEXP INDEX). 
  10785.  
  10786. MENU-TITLE is a string used as the title for the submenu or nil if the
  10787. entries are not nested.
  10788.  
  10789. REGEXP is a regexp that should match a construct in the buffer that is
  10790. to be displayed in the menu; i.e., function or variable definitions,
  10791. etc.  It contains a substring which is the name to appear in the
  10792. menu.  See the info section on Regexps for more information.
  10793.  
  10794. INDEX points to the substring in REGEXP that contains the name (of the
  10795. function, variable or type) that is to appear in the menu.
  10796.  
  10797. For emacs-lisp-mode for example PATTERN would look like:
  10798.  
  10799. '((nil "^\\s-*(def\\(un\\|subst\\|macro\\|advice\\)\\s-+\\([-A-Za-z0-9+]+\\)" 2)
  10800.   ("*Vars*" "^\\s-*(def\\(var\\|const\\)\\s-+\\([-A-Za-z0-9+]+\\)" 2)
  10801.   ("*Types*" "^\\s-*(def\\(type\\|struct\\|class\\|ine-condition\\)\\s-+\\([-A-Za-z0-9+]+\\)" 2))
  10802.  
  10803. The variable is buffer-local.Fimenu-add-to-menubar
  10804. Adds an `imenu' entry to the menu bar for the current buffer.
  10805. NAME is a string used to name the menu bar item.
  10806. See the command `imenu' for more information.Fimenu
  10807. Jump to a place in the buffer chosen using a buffer menu or mouse menu.
  10808. See `imenu-choose-buffer-index' for more information.Vinferior-lisp-filter-regexp
  10809. *What not to save on inferior Lisp's input history.
  10810. Input matching this regexp is not saved on the input history in Inferior Lisp
  10811. mode.  Default is whitespace followed by 0 or 1 single-letter colon-keyword 
  10812. (as in :a, :c, etc.)Vinferior-lisp-program
  10813. *Program name for invoking an inferior Lisp with for Inferior Lisp mode.Vinferior-lisp-load-command
  10814. *Format-string for building a Lisp expression to load a file.
  10815. This format string should use `%s' to substitute a file name
  10816. and should result in a Lisp expression that will command the inferior Lisp
  10817. to load that file.  The default works acceptably on most Lisps.
  10818. The string "(progn (load \"%s\" :verbose nil :print t) (values))\n"
  10819. produces cosmetically superior output for this application,
  10820. but it works only in Common Lisp.Vinferior-lisp-prompt
  10821. Regexp to recognise prompts in the Inferior Lisp mode.
  10822. Defaults to "^[^> \n]*>+:? *", which works pretty good for Lucid, kcl,
  10823. and franz.  This variable is used to initialize `comint-prompt-regexp' in the 
  10824. Inferior Lisp buffer.
  10825.  
  10826. More precise choices:
  10827. Lucid Common Lisp: "^\\(>\\|\\(->\\)+\\) *"
  10828. franz: "^\\(->\\|<[0-9]*>:\\) *"
  10829. kcl: "^>+ *"
  10830.  
  10831. This is a fine thing to set in your .emacs file.Vinferior-lisp-mode-hook
  10832. *Hook for customising Inferior Lisp mode.Finferior-lisp
  10833. Run an inferior Lisp process, input and output via buffer `*inferior-lisp*'.
  10834. If there is a process already running in `*inferior-lisp*', just switch
  10835. to that buffer.
  10836. With argument, allows you to edit the command line (default is value
  10837. of `inferior-lisp-program').  Runs the hooks from
  10838. `inferior-lisp-mode-hook' (after the `comint-mode-hook' is run).
  10839. (Type \[describe-mode] in the process buffer for a list of commands.)Finfo
  10840. Enter Info, the documentation browser.
  10841. Optional argument FILE specifies the file to examine;
  10842. the default is the top-level directory of Info.
  10843.  
  10844. In interactive use, a prefix argument directs this command
  10845. to read a file name from the minibuffer.
  10846.  
  10847. The search path for Info files is in the variable `Info-directory-list'.
  10848. The top-level Info directory is made by combining all the files named `dir' 
  10849. in all the directories in that path.Finfo-standalone
  10850. Run Emacs as a standalone Info reader.
  10851. Usage:  emacs -f info-standalone [filename]
  10852. In standalone mode, \<Info-mode-map>\[Info-exit] exits Emacs itself.FInfo-goto-emacs-command-node
  10853. Go to the Info node in the Emacs manual for command COMMAND.
  10854. The command is found by looking up in Emacs manual's Command Index
  10855. or in another manual found via COMMAND's `info-file' property or
  10856. the variable `Info-file-list-for-emacs'.FInfo-goto-emacs-key-command-node
  10857. Go to the Info node in the Emacs manual the command bound to KEY, a string.
  10858. Interactively, if the binding is execute-extended-command, a command is read.
  10859. The command is found by looking up in Emacs manual's Command Index
  10860. or in another manual found via COMMAND's `info-file' property or
  10861. the variable `Info-file-list-for-emacs'.FInfo-tagify
  10862. Create or update Info-file tag table in current buffer.FInfo-split
  10863. Split an info file into an indirect file plus bounded-size subfiles.
  10864. Each subfile will be up to 50,000 characters plus one node.
  10865.  
  10866. To use this command, first visit a large Info file that has a tag
  10867. table.  The buffer is modified into a (small) indirect info file which
  10868. should be saved in place of the original visited file.
  10869.  
  10870. The subfiles are written in the same directory the original file is
  10871. in, with names generated by appending `-' and a number to the original
  10872. file name.  The indirect file still functions as an Info file, but it
  10873. contains just the tag table and a directory of subfiles.FInfo-validate
  10874. Check current buffer for validity as an Info file.
  10875. Check that every node pointer points to an existing node.Fbatch-info-validate
  10876. Runs `Info-validate' on the files remaining on the command line.
  10877. Must be used only with -batch, and kills Emacs on completion.
  10878. Each file will be processed even if an error occurred previously.
  10879. For example, invoke "emacs -batch -f batch-info-validate $info/ ~/*.info"Fiso-accents-mode
  10880. Toggle ISO Accents mode, in which accents modify the following letter.
  10881. This permits easy insertion of accented characters according to ISO-8859-1.
  10882. When Iso-accents mode is enabled, accent character keys
  10883. (`, ', ", ^, / and ~) do not self-insert; instead, they modify the following
  10884. letter key so that it inserts an ISO accented letter.
  10885.  
  10886. You can customize ISO Accents mode to a particular language
  10887. with the command `iso-accents-customize'.
  10888.  
  10889. Special combinations: ~c gives a c with cedilla,
  10890. ~d gives an Icelandic eth (d with dash).
  10891. ~t gives an Icelandic thorn.
  10892. "s gives German sharp s.
  10893. /a gives a with ring.
  10894. /e gives an a-e ligature.
  10895. ~< and ~> give guillemots.
  10896. ~! gives an inverted exclamation mark.
  10897. ~? gives an inverted question mark.
  10898.  
  10899. With an argument, a positive argument enables ISO Accents mode, 
  10900. and a negative argument disables it.Vispell-personal-dictionary
  10901. *File name of your personal spelling dictionary, or nil.
  10902. If nil, the default personal dictionary, "~/.ispell_DICTNAME" is used,
  10903. where DICTNAME is the name of your default dictionary.Vispell-dictionary-alist
  10904. An alist of dictionaries and their associated parameters.
  10905.  
  10906. Each element of this list is also a list:
  10907.  
  10908. (DICTIONARY-NAME CASECHARS NOT-CASECHARS OTHERCHARS MANY-OTHERCHARS-P
  10909.         ISPELL-ARGS EXTENDED-CHARACTER-MODE)
  10910.  
  10911. DICTIONARY-NAME is a possible value of variable `ispell-dictionary', nil
  10912. means the default dictionary.
  10913.  
  10914. CASECHARS is a regular expression of valid characters that comprise a
  10915. word.
  10916.  
  10917. NOT-CASECHARS is the opposite regexp of CASECHARS.
  10918.  
  10919. OTHERCHARS is a regular expression of other characters that are valid
  10920. in word constructs.  Otherchars cannot be adjacent to each other in a
  10921. word, nor can they begin or end a word.  This implies we can't check
  10922. "Stevens'" as a correct possessive and other correct formations.
  10923.  
  10924. Hint: regexp syntax requires the hyphen to be declared first here.
  10925.  
  10926. MANY-OTHERCHARS-P is non-nil if many otherchars are to be allowed in a
  10927. word instead of only one.
  10928.  
  10929. ISPELL-ARGS is a list of additional arguments passed to the ispell
  10930. subprocess.
  10931.  
  10932. EXTENDED-CHARACTER-MODE should be used when dictionaries are used which
  10933. have been configured in an Ispell affix file.  (For example, umlauts
  10934. can be encoded as \"a, a\", "a, ...)  Defaults are ~tex and ~nroff
  10935. in English.  This has the same effect as the command-line `-T' option.
  10936. The buffer Major Mode controls Ispell's parsing in tex or nroff mode,
  10937. but the dictionary can control the extended character mode.
  10938. Both defaults can be overruled in a buffer-local fashion. See
  10939. `ispell-parsing-keyword' for details on this.
  10940.  
  10941. Note that the CASECHARS and OTHERCHARS slots of the alist should
  10942. contain the same character set as casechars and otherchars in the
  10943. language.aff file (e.g., english.aff).Vispell-menu-map
  10944. Key map for ispell menuVispell-menu-lucid
  10945. Spelling menu for Lucid Emacs.Fispell-word
  10946. Check spelling of word under or before the cursor.
  10947. If the word is not found in dictionary, display possible corrections
  10948. in a window allowing you to choose one.
  10949.  
  10950. With a prefix argument (or if CONTINUE is non-nil),
  10951. resume interrupted spell-checking of a buffer or region.
  10952.  
  10953. If optional argument FOLLOWING is non-nil or if `ispell-following-word'
  10954. is non-nil when called interactively, then the following word
  10955. (rather than preceding) is checked when the cursor is not over a word.
  10956. When the optional argument QUIETLY is non-nil or `ispell-quietly' is non-nil
  10957. when called interactively, non-corrective messages are suppressed.
  10958.  
  10959. Word syntax described by `ispell-dictionary-alist' (which see).
  10960.  
  10961. This will check or reload the dictionary.  Use \[ispell-change-dictionary]
  10962. or \[ispell-region] to update the Ispell process.Fispell-help
  10963. Display a list of the options available when a misspelling is encountered.
  10964.  
  10965. Selections are:
  10966.  
  10967. DIGIT: Replace the word with a digit offered in the *Choices* buffer.
  10968. SPC:   Accept word this time.
  10969. `i':   Accept word and insert into private dictionary.
  10970. `a':   Accept word for this session.
  10971. `A':   Accept word and place in `buffer-local dictionary'.
  10972. `r':   Replace word with typed-in value.  Rechecked.
  10973. `R':   Replace word with typed-in value. Query-replaced in buffer. Rechecked.
  10974. `?':   Show these commands.
  10975. `x':   Exit spelling buffer.  Move cursor to original point.
  10976. `X':   Exit spelling buffer.  Leaves cursor at the current point, and permits
  10977.         the aborted check to be completed later.
  10978. `q':   Quit spelling session (Kills ispell process).
  10979. `l':   Look up typed-in replacement in alternate dictionary.  Wildcards okay.
  10980. `u':   Like `i', but the word is lower-cased first.
  10981. `m':   Like `i', but allows one to include dictionary completion information.
  10982. `C-l':  redraws screen
  10983. `C-r':  recursive edit
  10984. `C-z':  suspend emacs or iconify frameFispell-kill-ispell
  10985. Kill current Ispell process (so that you may start a fresh one).
  10986. With NO-ERROR, just return non-nil if there was no Ispell running.Fispell-change-dictionary
  10987. Change `ispell-dictionary' (q.v.) and kill old Ispell process.
  10988. A new one will be started as soon as necessary.
  10989.  
  10990. By just answering RET you can find out what the current dictionary is.
  10991.  
  10992. With prefix argument, set the default directory.Fispell-region
  10993. Interactively check a region for spelling errors.Fispell-buffer
  10994. Check the current buffer for spelling errors interactively.Fispell-complete-word
  10995. Look up word before or under point in dictionary (see lookup-words command)
  10996. and try to complete it.  If optional INTERIOR-FRAG is non-nil then the word
  10997. may be a character sequence inside of a word.
  10998.  
  10999. Standard ispell choices are then available.Fispell-complete-word-interior-frag
  11000. Completes word matching character sequence inside a word.Fispell-minor-mode
  11001. Toggle Ispell minor mode.
  11002. With prefix arg, turn Ispell minor mode on iff arg is positive.
  11003.  
  11004. In Ispell minor mode, pressing SPC or RET
  11005. warns you if the previous word is incorrectly spelled.Fispell-message
  11006. Check the spelling of a mail message or news post.
  11007. Don't check spelling of message headers except the Subject field.
  11008. Don't check included messages.
  11009.  
  11010. To abort spell checking of a message region and send the message anyway,
  11011. use the `x' command.  (Any subsequent regions will be checked.)
  11012. The `X' command aborts the message send so that you can edit the buffer.
  11013.  
  11014. To spell-check whenever a message is sent, include the appropriate lines
  11015. in your .emacs file:
  11016.    (add-hook 'message-send-hook 'ispell-message)
  11017.    (add-hook 'mail-send-hook  'ispell-message)
  11018.    (add-hook 'mh-before-send-letter-hook 'ispell-message)
  11019.  
  11020. You can bind this to the key C-c i in GNUS or mail by adding to
  11021. `news-reply-mode-hook' or `mail-mode-hook' the following lambda expression:
  11022.    (function (lambda () (local-set-key "\C-ci" 'ispell-message)))Fauto-compression-mode
  11023. Toggle automatic file compression and uncompression.
  11024. With prefix argument ARG, turn auto compression on if positive, else off.
  11025. Returns the new status of auto compression (non-nil means on).Flazy-lock-mode
  11026. Toggle Lazy Lock mode.
  11027. With arg, turn Lazy Lock mode on if and only if arg is positive.  Enable it
  11028. automatically in your `~/.emacs' by:
  11029.  
  11030.  (setq font-lock-support-mode 'lazy-lock-mode)
  11031.  
  11032. When Lazy Lock mode is enabled, fontification can be lazy in a number of ways:
  11033.  
  11034.  - Demand-driven buffer fontification if `lazy-lock-minimum-size' is non-nil.
  11035.    This means initial fontification does not occur if the buffer is greater
  11036.    than `lazy-lock-minimum-size' characters in length.  Instead, fontification
  11037.    occurs when necessary, such as when scrolling through the buffer would
  11038.    otherwise reveal unfontified areas.  This is useful if buffer fontification
  11039.    is too slow for large buffers.
  11040.  
  11041.  - Defer-driven buffer fontification if `lazy-lock-defer-driven' is non-nil.
  11042.    This means all fontification is deferred, such as fontification that occurs
  11043.    when scrolling through the buffer would otherwise reveal unfontified areas.
  11044.    Instead, these areas are seen momentarily unfontified.  This is useful if
  11045.    demand-driven fontification is too slow to keep up with scrolling.
  11046.  
  11047.  - Deferred on-the-fly fontification if `lazy-lock-defer-time' is non-nil.
  11048.    This means on-the-fly fontification does not occur as you type.  Instead,
  11049.    fontification is deferred until after `lazy-lock-defer-time' seconds of
  11050.    Emacs idle time, while Emacs remains idle.  This is useful if on-the-fly
  11051.    fontification is too slow to keep up with your typing.
  11052.  
  11053.  - Stealthy buffer fontification if `lazy-lock-stealth-time' is non-nil.
  11054.    This means remaining unfontified areas of buffers are fontified if Emacs has
  11055.    been idle for `lazy-lock-stealth-time' seconds, while Emacs remains idle.
  11056.    This is useful if any buffer has demand- or defer-driven fontification.
  11057.  
  11058. See also variables `lazy-lock-stealth-lines', `lazy-lock-stealth-nice' and
  11059. `lazy-lock-stealth-verbose' for stealth fontification.
  11060.  
  11061. Use \[lazy-lock-submit-bug-report] to send bug reports or feedback.Fturn-on-lazy-lock
  11062. Unconditionally turn on Lazy Lock mode.Vledit-save-files
  11063. *Non-nil means Ledit should save files before transferring to Lisp.Vledit-go-to-lisp-string
  11064. *Shell commands to execute to resume Lisp job.Vledit-go-to-liszt-string
  11065. *Shell commands to execute to resume Lisp compiler job.Fledit-mode
  11066. \<ledit-mode-map>Major mode for editing text and stuffing it to a Lisp job.
  11067. Like Lisp mode, plus these special commands:
  11068.   \[ledit-save-defun]    -- record defun at or after point
  11069.        for later transmission to Lisp job.
  11070.   \[ledit-save-region] -- record region for later transmission to Lisp job.
  11071.   \[ledit-go-to-lisp] -- transfer to Lisp job and transmit saved text.
  11072.   \[ledit-go-to-liszt] -- transfer to Liszt (Lisp compiler) job
  11073.        and transmit saved text.
  11074. \{ledit-mode-map}
  11075. To make Lisp mode automatically change to Ledit mode,
  11076. do (setq lisp-mode-hook 'ledit-from-lisp-mode)Flife
  11077. Run Conway's Life simulation.
  11078. The starting pattern is randomly selected.  Prefix arg (optional first
  11079. arg non-nil from a program) is the number of seconds to sleep between
  11080. generations (this defaults to 1).Funload-feature
  11081. Unload the library that provided FEATURE, restoring all its autoloads.
  11082. If the feature is required by any other loaded code, and optional FORCE
  11083. is nil, raise an error.Vlpr-switches
  11084. *List of strings to pass as extra options for the printer program.
  11085. See `lpr-command'.Vlpr-command
  11086. *Name of program for printing a file.Flpr-buffer
  11087. Print buffer contents as with Unix command `lpr'.
  11088. `lpr-switches' is a list of extra switches (strings) to pass to lpr.Fprint-buffer
  11089. Print buffer contents as with Unix command `lpr -p'.
  11090. `lpr-switches' is a list of extra switches (strings) to pass to lpr.Flpr-region
  11091. Print region contents as with Unix command `lpr'.
  11092. `lpr-switches' is a list of extra switches (strings) to pass to lpr.Fprint-region
  11093. Print region contents as with Unix command `lpr -p'.
  11094. `lpr-switches' is a list of extra switches (strings) to pass to lpr.Vls-lisp-support-shell-wildcards
  11095. *Non-nil means file patterns are treated as shell wildcards.
  11096. nil means they are treated as Emacs regexps (for backward compatibility).
  11097. This variable is checked by \[insert-directory] only when `ls-lisp.el'
  11098. package is used.Fphases-of-moon
  11099. Display the quarters of the moon for last month, this month, and next month.
  11100. If called with an optional prefix argument, prompts for month and year.
  11101.  
  11102. This function is suitable for execution in a .emacs file.Fname-last-kbd-macro
  11103. Assign a name to the last keyboard macro defined.
  11104. Argument SYMBOL is the name to define.
  11105. The symbol's function definition becomes the keyboard macro string.
  11106. Such a "function" cannot be called from Lisp, but it is a valid editor command.Finsert-kbd-macro
  11107. Insert in buffer the definition of kbd macro NAME, as Lisp code.
  11108. Optional second arg KEYS means also record the keys it is on
  11109. (this is the prefix argument, when calling interactively).
  11110.  
  11111. This Lisp code will, when executed, define the kbd macro with the same
  11112. definition it has now.  If you say to record the keys, the Lisp code
  11113. will also rebind those keys to the macro.  Only global key bindings
  11114. are recorded since executing this Lisp code always makes global
  11115. bindings.
  11116.  
  11117. To save a kbd macro, visit a file of Lisp code such as your `~/.emacs',
  11118. use this command, and then save the file.Fkbd-macro-query
  11119. Query user during kbd macro execution.
  11120.   With prefix argument, enters recursive edit, reading keyboard
  11121. commands even within a kbd macro.  You can give different commands
  11122. each time the macro executes.
  11123.   Without prefix argument, asks whether to continue running the macro.
  11124. Your options are: \<query-replace-map>
  11125. \[act]    Finish this iteration normally and continue with the next.
  11126. \[skip]    Skip the rest of this iteration, and start the next.
  11127. \[exit]    Stop the macro entirely right now.
  11128. \[recenter]    Redisplay the screen, then ask again.
  11129. \[edit]    Enter recursive edit; ask again when you exit from that.Fapply-macro-to-region-lines
  11130. For each complete line between point and mark, move to the beginning
  11131. of the line, and run the last keyboard macro.
  11132.  
  11133. When called from lisp, this function takes two arguments TOP and
  11134. BOTTOM, describing the current region.  TOP must be before BOTTOM.
  11135. The optional third argument MACRO specifies a keyboard macro to
  11136. execute.
  11137.  
  11138. This is useful for quoting or unquoting included text, adding and
  11139. removing comments, or producing tables where the entries are regular.
  11140.  
  11141. For example, in Usenet articles, sections of text quoted from another
  11142. author are indented, or have each line start with `>'.  To quote a
  11143. section of text, define a keyboard macro which inserts `>', put point
  11144. and mark at opposite ends of the quoted section, and use
  11145. `\[apply-macro-to-region-lines]' to mark the entire section.
  11146.  
  11147. Suppose you wanted to build a keyword table in C where each entry
  11148. looked like this:
  11149.  
  11150.     { "foo", foo_data, foo_function }, 
  11151.     { "bar", bar_data, bar_function },
  11152.     { "baz", baz_data, baz_function },
  11153.  
  11154. You could enter the names in this format:
  11155.  
  11156.     foo
  11157.     bar
  11158.     baz
  11159.  
  11160. and write a macro to massage a word into a table entry:
  11161.  
  11162.     \C-x (
  11163.        \M-d { "\C-y", \C-y_data, \C-y_function },
  11164.     \C-x )
  11165.  
  11166. and then select the region of un-tablified names and use
  11167. `\[apply-macro-to-region-lines]' to build the table from the names.
  11168. Fmail-extract-address-components
  11169. Given an RFC-822 ADDRESS, extract full name and canonical address.
  11170. Returns a list of the form (FULL-NAME CANONICAL-ADDRESS).
  11171. If no name can be extracted, FULL-NAME will be nil.
  11172. ADDRESS may be a string or a buffer.  If it is a buffer, the visible 
  11173.  (narrowed) portion of the buffer will be interpreted as the address.
  11174.  (This feature exists so that the clever caller might be able to avoid
  11175.  consing a string.)
  11176. If ADDRESS contains more than one RFC-822 address, only the first is
  11177.  returned.  Some day this function may be extended to extract multiple
  11178.  addresses, or perhaps return the position at which parsing stopped.Fwhat-domain
  11179. Convert mail domain DOMAIN to the country it corresponds to.Fmail-hist-define-keys
  11180. Define keys for accessing mail header history.  For use in hooks.Vmail-hist-keep-history
  11181. *Non-nil means keep a history for headers and text of outgoing mail.Fmail-hist-put-headers-into-history
  11182. Put headers and contents of this message into mail header history. 
  11183. Each header has its own independent history, as does the body of the
  11184. message.
  11185.  
  11186. This function normally would be called when the message is sent.Vmail-use-rfc822
  11187. *If non-nil, use a full, hairy RFC822 parser on mail addresses.
  11188. Otherwise, (the default) use a smaller, somewhat faster, and
  11189. often correct parser.Fmail-fetch-field
  11190. Return the value of the header field FIELD-NAME.
  11191. The buffer is expected to be narrowed to just the headers of the message.
  11192. If second arg LAST is non-nil, use the last such field if there are several.
  11193. If third arg ALL is non-nil, concatenate all such fields with commas between.Fmail-abbrevs-setup
  11194. Initialize use of the `mailabbrev' package.Fbuild-mail-abbrevs
  11195. Read mail aliases from personal mail alias file and set `mail-abbrevs'.
  11196. By default this is the file specified by `mail-personal-alias-file'.Fdefine-mail-abbrev
  11197. Define NAME as a mail alias abbrev that translates to DEFINITION.
  11198. If DEFINITION contains multiple addresses, separate them with commas.Fdefine-mail-alias
  11199. Define NAME as a mail alias that translates to DEFINITION.
  11200. This means that sending a message to NAME will actually send to DEFINITION.
  11201.  
  11202. Normally, the addresses in DEFINITION must be separated by commas.
  11203. If FROM-MAILRC-FILE is non-nil, then addresses in DEFINITION 
  11204. can be separated by spaces; an address can contain spaces
  11205. if it is quoted with double-quotes.Fmail-complete
  11206. Perform completion on header field or word preceding point.
  11207. Completable headers are according to `mail-complete-alist'.  If none matches
  11208. current header, calls `mail-complete-function' and passes prefix arg if any.Fmakefile-mode
  11209. Major mode for editing Makefiles.
  11210. This function ends by invoking the function(s) `makefile-mode-hook'.
  11211.  
  11212. \{makefile-mode-map}
  11213.  
  11214. In the browser, use the following keys:
  11215.  
  11216. \{makefile-browser-map}
  11217.  
  11218. Makefile mode can be configured by modifying the following variables:
  11219.  
  11220. makefile-browser-buffer-name:
  11221.     Name of the macro- and target browser buffer.
  11222.  
  11223. makefile-target-colon:
  11224.     The string that gets appended to all target names
  11225.     inserted by `makefile-insert-target'.
  11226.     ":" or "::" are quite common values.
  11227.  
  11228. makefile-macro-assign:
  11229.    The string that gets appended to all macro names
  11230.    inserted by `makefile-insert-macro'.
  11231.    The normal value should be " = ", since this is what
  11232.    standard make expects. However, newer makes such as dmake
  11233.    allow a larger variety of different macro assignments, so you
  11234.    might prefer to use " += " or " := " .
  11235.  
  11236. makefile-tab-after-target-colon:
  11237.    If you want a TAB (instead of a space) to be appended after the
  11238.    target colon, then set this to a non-nil value.
  11239.  
  11240. makefile-browser-leftmost-column:
  11241.    Number of blanks to the left of the browser selection mark.
  11242.  
  11243. makefile-browser-cursor-column:
  11244.    Column in which the cursor is positioned when it moves
  11245.    up or down in the browser.
  11246.  
  11247. makefile-browser-selected-mark:
  11248.    String used to mark selected entries in the browser.
  11249.  
  11250. makefile-browser-unselected-mark:
  11251.    String used to mark unselected entries in the browser.
  11252.  
  11253. makefile-browser-auto-advance-after-selection-p:
  11254.    If this variable is set to a non-nil value the cursor
  11255.    will automagically advance to the next line after an item
  11256.    has been selected in the browser.
  11257.  
  11258. makefile-pickup-everything-picks-up-filenames-p:
  11259.    If this variable is set to a non-nil value then
  11260.    `makefile-pickup-everything' also picks up filenames as targets
  11261.    (i.e. it calls `makefile-find-filenames-as-targets'), otherwise
  11262.    filenames are omitted.
  11263.  
  11264. makefile-cleanup-continuations-p:
  11265.    If this variable is set to a non-nil value then makefile-mode
  11266.    will assure that no line in the file ends with a backslash
  11267.    (the continuation character) followed by any whitespace.
  11268.    This is done by silently removing the trailing whitespace, leaving
  11269.    the backslash itself intact.
  11270.    IMPORTANT: Please note that enabling this option causes makefile-mode
  11271.    to MODIFY A FILE WITHOUT YOUR CONFIRMATION when "it seems necessary".
  11272.  
  11273. makefile-browser-hook:
  11274.    A function or list of functions to be called just before the
  11275.    browser is entered. This is executed in the makefile buffer.
  11276.  
  11277. makefile-special-targets-list:
  11278.    List of special targets. You will be offered to complete
  11279.    on one of those in the minibuffer whenever you enter a `.'.
  11280.    at the beginning of a line in Makefile mode.Fmake-command-summary
  11281. Make a summary of current key bindings in the buffer *Summary*.
  11282. Previous contents of that buffer are killed first.Fman
  11283. Get a Un*x manual page and put it in a buffer.
  11284. This command is the top-level command in the man package.  It runs a Un*x
  11285. command to retrieve and clean a manpage in the background and places the
  11286. results in a Man mode (manpage browsing) buffer.  See variable
  11287. `Man-notify-method' for what happens when the buffer is ready.
  11288. If a buffer already exists for this man page, it will display immediately.Vmessage-fcc-handler-function
  11289. *A function called to save outgoing articles.
  11290. This function will be called with the name of the file to store the
  11291. article in. The default function is `rmail-output' which saves in Unix
  11292. mailbox format.Vmessage-courtesy-message
  11293. *This is inserted at the start of a mailed copy of a posted message.
  11294. If this variable is nil, no such courtesy message will be added.Vmessage-ignored-bounced-headers
  11295. *Regexp that matches headers to be removed in resent bounced mail.Vmessage-from-style
  11296. *Specifies how "From" headers look.
  11297.  
  11298. If `nil', they contain just the return address like:
  11299.     king@grassland.com
  11300. If `parens', they look like:
  11301.     king@grassland.com (Elvis Parsley)
  11302. If `angles', they look like:
  11303.     Elvis Parsley <king@grassland.com>
  11304.  
  11305. Otherwise, most addresses look like `angles', but they look like
  11306. `parens' if `angles' would need quoting and `parens' would not.Vmessage-syntax-checks
  11307. Controls what syntax checks should not be performed on outgoing posts.
  11308. To disable checking of long signatures, for instance, add
  11309.  `(signature . disabled)' to this list.
  11310.  
  11311. Don't touch this variable unless you really know what you're doing.
  11312.  
  11313. Checks include subject-cmsg multiple-headers sendsys message-id from
  11314. long-lines control-chars size new-text redirected-followup signature
  11315. approved sender empty empty-headers message-id from subject.Vmessage-required-news-headers
  11316. *Headers to be generated or prompted for when posting an article.
  11317. RFC977 and RFC1036 require From, Date, Newsgroups, Subject,
  11318. Message-ID.  Organization, Lines, In-Reply-To, Expires, and
  11319. X-Newsreader are optional.  If don't you want message to insert some
  11320. header, remove it from this list.Vmessage-required-mail-headers
  11321. *Headers to be generated or prompted for when mailing a message.
  11322. RFC822 required that From, Date, To, Subject and Message-ID be
  11323. included.  Organization, Lines and X-Mailer are optional.Vmessage-deletable-headers
  11324. *Headers to be deleted if they already exist and were generated by message previously.Vmessage-ignored-news-headers
  11325. *Regexp of headers to be removed unconditionally before posting.Vmessage-ignored-mail-headers
  11326. *Regexp of headers to be removed unconditionally before mailing.Vmessage-ignored-supersedes-headers
  11327. *Header lines matching this regexp will be deleted before posting.
  11328. It's best to delete old Path and Date headers before posting to avoid
  11329. any confusion.Vmessage-signature-separator
  11330. Regexp matching the signature separator.Vmessage-interactive
  11331. Non-nil means when sending a message wait for and display errors.
  11332. nil means let mailer mail back a message to report errors.Vmessage-generate-new-buffers
  11333. *Non-nil means that a new message buffer will be created whenever `mail-setup' is called.
  11334. If this is a function, call that function with three parameters:  The type,
  11335. the to address and the group name.  (Any of these may be nil.)  The function
  11336. should return the new buffer name.Vmessage-kill-buffer-on-exit
  11337. *Non-nil means that the message buffer will be killed after sending a message.Vmessage-user-organization-file
  11338. *Local news organization file.Vmessage-signature-before-forwarded-message
  11339. *If non-nil, put the signature before any included forwarded message.Vmessage-included-forward-headers
  11340. *Regexp matching headers to be included in forwarded messages.Vmessage-ignored-resent-headers
  11341. *All headers that match this regexp will be deleted when resending a message.Vmessage-ignored-cited-headers
  11342. Delete these headers from the messages you yank.Vmessage-send-mail-function
  11343. Function to call to send the current buffer as mail.
  11344. The headers should be delimited by a line whose contents match the
  11345. variable `mail-header-separator'.
  11346.  
  11347. Legal values include `message-send-mail-with-mh' and
  11348. `message-send-mail-with-sendmail', which is the default.Vmessage-send-news-function
  11349. Function to call to send the current buffer as news.
  11350. The headers should be delimited by a line whose contents match the
  11351. variable `mail-header-separator'.Vmessage-reply-to-function
  11352. Function that should return a list of headers.
  11353. This function should pick out addresses from the To, Cc, and From headers
  11354. and respond with new To and Cc headers.Vmessage-wide-reply-to-function
  11355. Function that should return a list of headers.
  11356. This function should pick out addresses from the To, Cc, and From headers
  11357. and respond with new To and Cc headers.Vmessage-followup-to-function
  11358. Function that should return a list of headers.
  11359. This function should pick out addresses from the To, Cc, and From headers
  11360. and respond with new To and Cc headers.Vmessage-use-followup-to
  11361. *Specifies what to do with Followup-To header.
  11362. If nil, ignore the header. If it is t, use its value, but query before
  11363. using the "poster" value.  If it is the symbol `ask', query the user
  11364. whether to ignore the "poster" value.  If it is the symbol `use',
  11365. always use the value.Vmessage-post-method
  11366. Method used to post news.Vmessage-generate-headers-first
  11367. *If non-nil, generate all possible headers before composing.Vmessage-citation-line-function
  11368. *Function called to insert the "Whomever writes:" line.Vmessage-yank-prefix
  11369. *Prefix inserted on the lines of yanked messages.
  11370. nil means use indentation.Vmessage-cite-function
  11371. *Function for citing an original message.Vmessage-indent-citation-function
  11372. *Function for modifying a citation just inserted in the mail buffer.
  11373. This can also be a list of functions.  Each function can find the
  11374. citation between (point) and (mark t).  And each function should leave
  11375. point and mark around the citation text as modified.Vmessage-signature
  11376. *String to be inserted at the end of the message buffer.
  11377. If t, the `message-signature-file' file will be inserted instead.
  11378. If a function, the result from the function will be used instead.
  11379. If a form, the result from the form will be used instead.Vmessage-signature-file
  11380. *File containing the text inserted at end of message. buffer.Vmessage-default-headers
  11381. *A string containing header lines to be inserted in outgoing messages.
  11382. It is inserted before you edit the message, so you can edit or delete
  11383. these lines.Vmessage-default-mail-headers
  11384. *A string of header lines to be inserted in outgoing mails.Vmessage-default-news-headers
  11385. *A string of header lines to be inserted in outgoing news articles.Fmessage-mode
  11386. Major mode for editing mail and news to be sent.
  11387. Like Text Mode but with these additional commands:
  11388. C-c C-s  message-send (send the message)    C-c C-c  message-send-and-exit
  11389. C-c C-f  move to a header field (and create it if there isn't):
  11390.      C-c C-f C-t  move to To    C-c C-f C-s  move to Subject
  11391.      C-c C-f C-c  move to Cc    C-c C-f C-b  move to Bcc
  11392.      C-c C-f C-f  move to Fcc    C-c C-f C-r  move to Reply-To
  11393.      C-c C-f C-u  move to Summary    C-c C-f C-n  move to Newsgroups
  11394.      C-c C-f C-k  move to Keywords    C-c C-f C-d  move to Distribution
  11395.      C-c C-f C-o  move to Followup-To
  11396. C-c C-t  message-insert-to (add a To header to a news followup)
  11397. C-c C-n  message-insert-newsgroups (add a Newsgroup header to a news reply)
  11398. C-c C-b  message-goto-body (move to beginning of message text).
  11399. C-c C-i  message-goto-signature (move to the beginning of the signature).
  11400. C-c C-w  message-insert-signature (insert `message-signature-file' file).
  11401. C-c C-y  message-yank-original (insert current message, if any).
  11402. C-c C-q  message-fill-yanked-message (fill what was yanked).
  11403. C-c C-r  message-ceasar-buffer-body (rot13 the message body).Fmessage-mail
  11404. Start editing a mail message to be sent.Fmessage-news
  11405. Start editing a news article to be sent.Fmessage-reply
  11406. Start editing a reply to the article in the current buffer.Fmessage-cancel-news
  11407. Cancel an article you posted.Fmessage-supersede
  11408. Start composing a message to supersede the current message.
  11409. This is done simply by taking the old article and adding a Supersedes
  11410. header line with the old Message-ID.Fmessage-recover
  11411. Reread contents of current buffer from its last auto-save file.Fmessage-forward
  11412. Forward the current message via mail.  
  11413. Optional NEWS will use news to forward instead of mail.Fmessage-resend
  11414. Resend the current article to ADDRESS.Fmessage-bounce
  11415. Re-mail the current message.
  11416. This only makes sense if the current message is a bounce message than
  11417. contains some mail you have written which has been bounced back to
  11418. you.Fmessage-mail-other-window
  11419. Like `message-mail' command, but display mail buffer in another window.Fmessage-mail-other-frame
  11420. Like `message-mail' command, but display mail buffer in another frame.Fmessage-news-other-window
  11421. Start editing a news article to be sent.Fmessage-news-other-frame
  11422. Start editing a news article to be sent.Fbold-region
  11423. Bold all nonblank characters in the region.
  11424. Works by overstriking characters.
  11425. Called from program, takes two arguments START and END
  11426. which specify the range to operate on.Funbold-region
  11427. Remove all boldness (overstruck characters) in the region.
  11428. Called from program, takes two arguments START and END
  11429. which specify the range to operate on.Fmetamail-interpret-header
  11430. Interpret a header part of a MIME message in current buffer.
  11431. Its body part is not interpreted at all.Fmetamail-interpret-body
  11432. Interpret a body part of a MIME message in current buffer.
  11433. Optional argument VIEWMODE specifies the value of the
  11434. EMACS_VIEW_MODE environment variable (defaulted to 1).
  11435. Optional argument NODISPLAY non-nil means buffer is not
  11436. redisplayed as output is inserted.
  11437. Its header part is not interpreted at all.Fmetamail-buffer
  11438. Process current buffer through `metamail'.
  11439. Optional argument VIEWMODE specifies the value of the
  11440. EMACS_VIEW_MODE environment variable (defaulted to 1).
  11441. Optional argument BUFFER specifies a buffer to be filled (nil
  11442. means current).
  11443. Optional argument NODISPLAY non-nil means buffer is not
  11444. redisplayed as output is inserted.Fmetamail-region
  11445. Process current region through 'metamail'.
  11446. Optional argument VIEWMODE specifies the value of the
  11447. EMACS_VIEW_MODE environment variable (defaulted to 1).
  11448. Optional argument BUFFER specifies a buffer to be filled (nil
  11449. means current).
  11450. Optional argument NODISPLAY non-nil means buffer is not
  11451. redisplayed as output is inserted.Fmh-smail
  11452. Compose and send mail with the MH mail system.
  11453. This function is an entry point to mh-e, the Emacs front end
  11454. to the MH mail system.
  11455.  
  11456. See documentation of `\[mh-send]' for more details on composing mail.Fmh-smail-batch
  11457. Set up a mail composition draft with the MH mail system.
  11458. This function is an entry point to mh-e, the Emacs front end
  11459. to the MH mail system.  This function does not prompt the user
  11460. for any header fields, and thus is suitable for use by programs
  11461. that want to create a mail buffer.
  11462. Users should use `\[mh-smail]' to compose mail.Fmh-smail-other-window
  11463. Compose and send mail in other window with the MH mail system.
  11464. This function is an entry point to mh-e, the Emacs front end
  11465. to the MH mail system.
  11466.  
  11467. See documentation of `\[mh-send]' for more details on composing mail.Fmh-letter-mode
  11468. Mode for composing letters in mh-e.\<mh-letter-mode-map>
  11469. When you have finished composing, type \[mh-send-letter] to send the message
  11470. using the MH mail handling system.
  11471. See the documentation for \[mh-edit-mhn] for information on composing MIME
  11472. messages.
  11473.  
  11474. \{mh-letter-mode-map}
  11475.  
  11476. Variables controlling this mode (defaults in parentheses):
  11477.  
  11478.  mh-delete-yanked-msg-window (nil)
  11479.     If non-nil, \[mh-yank-cur-msg] will delete any windows displaying
  11480.     the yanked message.
  11481.  
  11482.  mh-yank-from-start-of-msg (t)
  11483.     If non-nil, \[mh-yank-cur-msg] will include the entire message.
  11484.     If `body', just yank the body (no header).
  11485.     If nil, only the portion of the message following the point will be yanked.
  11486.     If there is a region, this variable is ignored.
  11487.  
  11488.  mh-ins-buf-prefix ("> ")
  11489.     String to insert before each non-blank line of a message as it is
  11490.     inserted in a draft letter.
  11491.  
  11492.  mh-signature-file-name ("~/.signature")
  11493.     File to be inserted into message by \[mh-insert-signature].
  11494.  
  11495. Upon invoking mh-letter-mode, text-mode-hook and mh-letter-mode-hook are
  11496. invoked with no args, if those values are non-nil.Fmh-rmail
  11497. Inc(orporate) new mail with MH, or, with arg, scan an MH mail folder.
  11498. This function is an entry point to mh-e, the Emacs front end
  11499. to the MH mail system.Fmh-version
  11500. Display version information about mh-e and the MH mail handling system.Vmh-mime-content-types
  11501. Legal MIME content types.  See documentation for \[mh-edit-mhn].Fconvert-mocklisp-buffer
  11502. Convert buffer of Mocklisp code to real Lisp that GNU Emacs can run.Fmodula-2-mode
  11503. This is a mode intended to support program development in Modula-2.
  11504. All control constructs of Modula-2 can be reached by typing C-c
  11505. followed by the first character of the construct.
  11506. \<m2-mode-map>
  11507.   \[m2-begin] begin         \[m2-case] case
  11508.   \[m2-definition] definition    \[m2-else] else
  11509.   \[m2-for] for           \[m2-header] header
  11510.   \[m2-if] if            \[m2-module] module
  11511.   \[m2-loop] loop          \[m2-or] or
  11512.   \[m2-procedure] procedure     Control-c Control-w with
  11513.   \[m2-record] record        \[m2-stdio] stdio
  11514.   \[m2-type] type          \[m2-until] until
  11515.   \[m2-var] var           \[m2-while] while
  11516.   \[m2-export] export        \[m2-import] import
  11517.   \[m2-begin-comment] begin-comment \[m2-end-comment] end-comment
  11518.   \[suspend-emacs] suspend Emacs     \[m2-toggle] toggle
  11519.   \[m2-compile] compile           \[m2-next-error] next-error
  11520.   \[m2-link] link
  11521.  
  11522.    `m2-indent' controls the number of spaces for each indentation.
  11523.    `m2-compile-command' holds the command to compile a Modula-2 program.
  11524.    `m2-link-command' holds the command to link a Modula-2 program.Fmpuz
  11525. Multiplication puzzle with GNU Emacs.Fnnfolder-generate-active-file
  11526. Look for mbox folders in the nnfolder directory and make them into groups.Fnnkiboze-generate-groups
  11527. Usage: emacs -batch -l nnkiboze -f nnkiboze-generate-groups
  11528. Finds out what articles are to be part of the nnkiboze groups.Fnnml-generate-nov-databases
  11529. Generate nov databases in all nnml directories.Fnnsoup-pack-replies
  11530. Make an outbound package of SOUP replies.Fnnsoup-set-variables
  11531. Use the SOUP methods for posting news and mailing mail.Fnnsoup-revert-variables
  11532. Revert posting and mailing methods to the standard Emacs methods.Fenable-command
  11533. Allow COMMAND to be executed without special confirmation from now on.
  11534. The user's .emacs file is altered so that this will apply
  11535. to future sessions.Fdisable-command
  11536. Require special confirmation to execute COMMAND from now on.
  11537. The user's .emacs file is altered so that this will apply
  11538. to future sessions.Fnroff-mode
  11539. Major mode for editing text intended for nroff to format.
  11540. \{nroff-mode-map}
  11541. Turning on Nroff mode runs `text-mode-hook', then `nroff-mode-hook'.
  11542. Also, try `nroff-electric-mode', for automatically inserting
  11543. closing requests for requests that are used in matched pairs.Flist-options
  11544. Display a list of Emacs user options, with values and documentation.Fedit-options
  11545. Edit a list of Emacs user option values.
  11546. Selects a buffer containing such a list,
  11547. in which there are commands to set the option values.
  11548. Type \[describe-mode] in that buffer for a list of commands.Foutline-mode
  11549. Set major mode for editing outlines with selective display.
  11550. Headings are lines which start with asterisks: one for major headings,
  11551. two for subheadings, etc.  Lines not starting with asterisks are body lines.
  11552.  
  11553. Body text or subheadings under a heading can be made temporarily
  11554. invisible, or visible again.  Invisible lines are attached to the end
  11555. of the heading, so they move with it, if the line is killed and yanked
  11556. back.  A heading with text hidden under it is marked with an ellipsis (...).
  11557.  
  11558. Commands:\<outline-mode-map>
  11559. \[outline-next-visible-heading]   outline-next-visible-heading      move by visible headings
  11560. \[outline-previous-visible-heading]   outline-previous-visible-heading
  11561. \[outline-forward-same-level]   outline-forward-same-level        similar but skip subheadings
  11562. \[outline-backward-same-level]   outline-backward-same-level
  11563. \[outline-up-heading]   outline-up-heading            move from subheading to heading
  11564.  
  11565. \[hide-body]    make all text invisible (not headings).
  11566. \[show-all]    make everything in buffer visible.
  11567.  
  11568. The remaining commands are used when point is on a heading line.
  11569. They apply to some of the body or subheadings of that heading.
  11570. \[hide-subtree]   hide-subtree    make body and subheadings invisible.
  11571. \[show-subtree]   show-subtree    make body and subheadings visible.
  11572. \[show-children]   show-children    make direct subheadings visible.
  11573.          No effect on body, or subheadings 2 or more levels down.
  11574.          With arg N, affects subheadings N levels down.
  11575. \[hide-entry]       make immediately following body invisible.
  11576. \[show-entry]       make it visible.
  11577. \[hide-leaves]       make body under heading and under its subheadings invisible.
  11578.              The subheadings remain visible.
  11579. \[show-branches]  make all subheadings at all levels visible.
  11580.  
  11581. The variable `outline-regexp' can be changed to control what is a heading.
  11582. A line is a heading if `outline-regexp' matches something at the
  11583. beginning of the line.  The longer the match, the deeper the level.
  11584.  
  11585. Turning on outline mode calls the value of `text-mode-hook' and then of
  11586. `outline-mode-hook', if they are non-nil.Foutline-minor-mode
  11587. Toggle Outline minor mode.
  11588. With arg, turn Outline minor mode on if arg is positive, off otherwise.
  11589. See the command `outline-mode' for more information on this mode.Fshow-paren-mode
  11590. Toggle Show Paren mode.
  11591. With prefix ARG, turn Show Paren mode on if and only if ARG is positive.
  11592. Returns the new status of Show Paren mode (non-nil means on).
  11593.  
  11594. When Show Paren mode is enabled, any matching parenthesis is highlighted
  11595. after `show-paren-delay' seconds of Emacs idle time.Fpascal-mode
  11596. Major mode for editing Pascal code. \<pascal-mode-map>
  11597. TAB indents for Pascal code.  Delete converts tabs to spaces as it moves back.
  11598.  
  11599. \[pascal-complete-word] completes the word around current point with respect to position in code
  11600. \[pascal-show-completions] shows all possible completions at this point.
  11601.  
  11602. Other useful functions are:
  11603.  
  11604. \[pascal-mark-defun]    - Mark function.
  11605. \[pascal-insert-block]    - insert begin ... end;
  11606. \[pascal-star-comment]    - insert (* ... *)
  11607. \[pascal-comment-area]    - Put marked area in a comment, fixing nested comments.
  11608. \[pascal-uncomment-area]    - Uncomment an area commented with \[pascal-comment-area].
  11609. \[pascal-beg-of-defun]    - Move to beginning of current function.
  11610. \[pascal-end-of-defun]    - Move to end of current function.
  11611. \[pascal-goto-defun]    - Goto function prompted for in the minibuffer.
  11612. \[pascal-outline]    - Enter pascal-outline-mode (see also pascal-outline).
  11613.  
  11614. Variables controlling indentation/edit style:
  11615.  
  11616.  pascal-indent-level      (default 3)
  11617.     Indentation of Pascal statements with respect to containing block.
  11618.  pascal-case-indent       (default 2)
  11619.     Indentation for case statements.
  11620.  pascal-auto-newline      (default nil)
  11621.     Non-nil means automatically newline after semicolons and the punctuation
  11622.     mark after an end.
  11623.  pascal-tab-always-indent (default t)
  11624.     Non-nil means TAB in Pascal mode should always reindent the current line,
  11625.     regardless of where in the line point is when the TAB command is used.
  11626.  pascal-auto-endcomments  (default t)
  11627.     Non-nil means a comment { ... } is set after the ends which ends cases and
  11628.     functions. The name of the function or case will be set between the braces.
  11629.  pascal-auto-lineup       (default t)
  11630.     List of contexts where auto lineup of :'s or ='s hould be done.
  11631.  
  11632. See also the user variables pascal-type-keywords, pascal-start-keywords and
  11633. pascal-separator-keywords.
  11634.  
  11635. Turning on Pascal mode calls the value of the variable pascal-mode-hook with
  11636. no args, if that value is non-nil.Fpc-bindings-mode
  11637. Set up certain key bindings for PC compatibility.
  11638. The keys affected are:
  11639. Delete (and its variants) delete forward instead of backward.
  11640. C-Backspace kills backward a word (as C-Delete normally would).
  11641. M-Backspace does undo.
  11642. Home and End move to beginning and end of line
  11643. C-Home and C-End move to beginning and end of buffer.
  11644. C-Escape does list-buffers.Fpc-selection-mode
  11645. Change mark behaviour to emulate motif, MAC or MS-Windows cut and paste style.
  11646.  
  11647. This mode will switch on delete-selection-mode and
  11648. transient-mark-mode.
  11649.  
  11650. The cursor keys (and others) are bound to new functions
  11651. which will modify the status of the mark. It will be
  11652. possible to select regions with shift-cursorkeys. All this
  11653. tries to emulate the look-and-feel of GUIs like motif,
  11654. the MAC GUI or MS-Windows (sorry for the last one).Fperl-mode
  11655. Major mode for editing Perl code.
  11656. Expression and list commands understand all Perl brackets.
  11657. Tab indents for Perl code.
  11658. Comments are delimited with # ... \n.
  11659. Paragraphs are separated by blank lines only.
  11660. Delete converts tabs to spaces as it moves back.
  11661. \{perl-mode-map}
  11662. Variables controlling indentation style:
  11663.  perl-tab-always-indent
  11664.     Non-nil means TAB in Perl mode should always indent the current line,
  11665.     regardless of where in the line point is when the TAB command is used.
  11666.  perl-tab-to-comment
  11667.     Non-nil means that for lines which don't need indenting, TAB will
  11668.     either delete an empty comment, indent an existing comment, move 
  11669.     to end-of-line, or if at end-of-line already, create a new comment.
  11670.  perl-nochange
  11671.     Lines starting with this regular expression are not auto-indented.
  11672.  perl-indent-level
  11673.     Indentation of Perl statements within surrounding block.
  11674.     The surrounding block's indentation is the indentation
  11675.     of the line on which the open-brace appears.
  11676.  perl-continued-statement-offset
  11677.     Extra indentation given to a substatement, such as the
  11678.     then-clause of an if or body of a while.
  11679.  perl-continued-brace-offset
  11680.     Extra indentation given to a brace that starts a substatement.
  11681.     This is in addition to `perl-continued-statement-offset'.
  11682.  perl-brace-offset
  11683.     Extra indentation for line if it starts with an open brace.
  11684.  perl-brace-imaginary-offset
  11685.     An open brace following other text is treated as if it were
  11686.     this far to the right of the start of its line.
  11687.  perl-label-offset
  11688.     Extra indentation for line that is a label.
  11689.  
  11690. Various indentation styles:       K&R  BSD  BLK  GNU  LW
  11691.   perl-indent-level                5    8    0    2    4
  11692.   perl-continued-statement-offset  5    8    4    2    4
  11693.   perl-continued-brace-offset      0    0    0    0   -4
  11694.   perl-brace-offset               -5   -8    0    0    0
  11695.   perl-brace-imaginary-offset      0    0    4    0    0
  11696.   perl-label-offset               -5   -8   -2   -2   -2
  11697.  
  11698. Turning on Perl mode runs the normal hook `perl-mode-hook'.Fpicture-mode
  11699. Switch to Picture mode, in which a quarter-plane screen model is used.
  11700. Printing characters replace instead of inserting themselves with motion
  11701. afterwards settable by these commands:
  11702.   C-c <      Move left after insertion.
  11703.   C-c >      Move right after insertion.
  11704.   C-c ^      Move up after insertion.
  11705.   C-c .      Move down after insertion.
  11706.   C-c `      Move northwest (nw) after insertion.
  11707.   C-c '      Move northeast (ne) after insertion.
  11708.   C-c /      Move southwest (sw) after insertion.
  11709.   C-c \   Move southeast (se) after insertion.
  11710. The current direction is displayed in the mode line.  The initial
  11711. direction is right.  Whitespace is inserted and tabs are changed to
  11712. spaces when required by movement.  You can move around in the buffer
  11713. with these commands:
  11714.   \[picture-move-down]      Move vertically to SAME column in previous line.
  11715.   \[picture-move-up]      Move vertically to SAME column in next line.
  11716.   \[picture-end-of-line]      Move to column following last non-whitespace character.
  11717.   \[picture-forward-column]      Move right inserting spaces if required.
  11718.   \[picture-backward-column]      Move left changing tabs to spaces if required.
  11719.   C-c C-f Move in direction of current picture motion.
  11720.   C-c C-b Move in opposite direction of current picture motion.
  11721.   Return  Move to beginning of next line.
  11722. You can edit tabular text with these commands:
  11723.   M-Tab      Move to column beneath (or at) next interesting character.
  11724.         `Indents' relative to a previous line.
  11725.   Tab      Move to next stop in tab stop list.
  11726.   C-c Tab Set tab stops according to context of this line.
  11727.         With ARG resets tab stops to default (global) value.
  11728.         See also documentation of variable    picture-tab-chars
  11729.         which defines "interesting character".  You can manually
  11730.         change the tab stop list with command \[edit-tab-stops].
  11731. You can manipulate text with these commands:
  11732.   C-d      Clear (replace) ARG columns after point without moving.
  11733.   C-c C-d Delete char at point - the command normally assigned to C-d.
  11734.   \[picture-backward-clear-column]  Clear (replace) ARG columns before point, moving back over them.
  11735.   \[picture-clear-line]      Clear ARG lines, advancing over them.     The cleared
  11736.         text is saved in the kill ring.
  11737.   \[picture-open-line]      Open blank line(s) beneath current line.
  11738. You can manipulate rectangles with these commands:
  11739.   C-c C-k Clear (or kill) a rectangle and save it.
  11740.   C-c C-w Like C-c C-k except rectangle is saved in named register.
  11741.   C-c C-y Overlay (or insert) currently saved rectangle at point.
  11742.   C-c C-x Like C-c C-y except rectangle is taken from named register.
  11743.   \[copy-rectangle-to-register]   Copies a rectangle to a register.
  11744.   \[advertised-undo]   Can undo effects of rectangle overlay commands
  11745.         commands if invoked soon enough.
  11746. You can return to the previous mode with:
  11747.   C-c C-c Which also strips trailing whitespace from every line.
  11748.         Stripping is suppressed by supplying an argument.
  11749.  
  11750. Entry to this mode calls the value of  picture-mode-hook  if non-nil.
  11751.  
  11752. Note that Picture mode commands will work outside of Picture mode, but
  11753. they are not defaultly assigned to keys.Fpp
  11754. Output the pretty-printed representation of OBJECT, any Lisp object.
  11755. Quoting characters are printed when needed to make output that `read'
  11756. can handle, whenever this is possible.
  11757. Output stream is STREAM, or value of `standard-output' (which see).Fpp-eval-expression
  11758. Evaluate EXPRESSION and pretty-print value into a new display buffer.
  11759. If the pretty-printed value fits on one line, the message line is used
  11760. instead.  Value is also consed on to front of variable  values 's
  11761. value.Fpp-eval-last-sexp
  11762. Run `pp-eval-expression' on sexp before point (which see).
  11763. With argument, pretty-print output into current buffer.
  11764. Ignores leading comment characters.Fprolog-mode
  11765. Major mode for editing Prolog code for Prologs.
  11766. Blank lines and `%%...' separate paragraphs.  `%'s start comments.
  11767. Commands:
  11768. \{prolog-mode-map}
  11769. Entry to this mode calls the value of `prolog-mode-hook'
  11770. if that value is non-nil.Frun-prolog
  11771. Run an inferior Prolog process, input and output via buffer *prolog*.Fps-print-buffer
  11772. Generate and print a PostScript image of the buffer.
  11773.  
  11774. When called with a numeric prefix argument (C-u), prompts the user for
  11775. the name of a file to save the PostScript image in, instead of sending
  11776. it to the printer.
  11777.  
  11778. More specifically, the FILENAME argument is treated as follows: if it
  11779. is nil, send the image to the printer.  If FILENAME is a string, save
  11780. the PostScript image in a file with that name.  If FILENAME is a
  11781. number, prompt the user for the name of the file to save in.Fps-print-buffer-with-faces
  11782. Generate and print a PostScript image of the buffer.
  11783. Like `ps-print-buffer', but includes font, color, and underline
  11784. information in the generated image.  This command works only if you
  11785. are using a window system, so it has a way to determine color values.Fps-print-region
  11786. Generate and print a PostScript image of the region.
  11787. Like `ps-print-buffer', but prints just the current region.Fps-print-region-with-faces
  11788. Generate and print a PostScript image of the region.
  11789. Like `ps-print-region', but includes font, color, and underline
  11790. information in the generated image.  This command works only if you
  11791. are using a window system, so it has a way to determine color values.Fps-spool-buffer
  11792. Generate and spool a PostScript image of the buffer.
  11793. Like `ps-print-buffer' except that the PostScript image is saved in a
  11794. local buffer to be sent to the printer later.
  11795.  
  11796. Use the command `ps-despool' to send the spooled images to the printer.Fps-spool-buffer-with-faces
  11797. Generate and spool a PostScript image of the buffer.
  11798. Like `ps-spool-buffer', but includes font, color, and underline
  11799. information in the generated image.  This command works only if you
  11800. are using a window system, so it has a way to determine color values.
  11801.  
  11802. Use the command `ps-despool' to send the spooled images to the printer.Fps-spool-region
  11803. Generate a PostScript image of the region and spool locally.
  11804. Like `ps-spool-buffer', but spools just the current region.
  11805.  
  11806. Use the command `ps-despool' to send the spooled images to the printer.Fps-spool-region-with-faces
  11807. Generate a PostScript image of the region and spool locally.
  11808. Like `ps-spool-region', but includes font, color, and underline
  11809. information in the generated image.  This command works only if you
  11810. are using a window system, so it has a way to determine color values.
  11811.  
  11812. Use the command `ps-despool' to send the spooled images to the printer.Fps-despool
  11813. Send the spooled PostScript to the printer.
  11814.  
  11815. When called with a numeric prefix argument (C-u), prompt the user for
  11816. the name of a file to save the spooled PostScript in, instead of sending
  11817. it to the printer.
  11818.  
  11819. More specifically, the FILENAME argument is treated as follows: if it
  11820. is nil, send the image to the printer.  If FILENAME is a string, save
  11821. the PostScript image in a file with that name.  If FILENAME is a
  11822. number, prompt the user for the name of the file to save in.Fremote-compile
  11823. Compile the the current buffer's directory on HOST.  Log in as USER.
  11824. See \[compile].Fdelete-rectangle
  11825. Delete (don't save) text in rectangle with point and mark as corners.
  11826. The same range of columns is deleted in each line starting with the line
  11827. where the region begins and ending with the line where the region ends.Fdelete-extract-rectangle
  11828. Delete contents of rectangle and return it as a list of strings.
  11829. Arguments START and END are the corners of the rectangle.
  11830. The value is list of strings, one for each line of the rectangle.Fextract-rectangle
  11831. Return contents of rectangle with corners at START and END.
  11832. Value is list of strings, one for each line of the rectangle.Fkill-rectangle
  11833. Delete rectangle with corners at point and mark; save as last killed one.
  11834. Calling from program, supply two args START and END, buffer positions.
  11835. But in programs you might prefer to use `delete-extract-rectangle'.Fyank-rectangle
  11836. Yank the last killed rectangle with upper left corner at point.Finsert-rectangle
  11837. Insert text of RECTANGLE with upper left corner at point.
  11838. RECTANGLE's first line is inserted at point, its second
  11839. line is inserted at a point vertically under point, etc.
  11840. RECTANGLE should be a list of strings.
  11841. After this command, the mark is at the upper left corner
  11842. and point is at the lower right corner.Fopen-rectangle
  11843. Blank out rectangle with corners at point and mark, shifting text right.
  11844. The text previously in the region is not overwritten by the blanks,
  11845. but instead winds up to the right of the rectangle.Fstring-rectangle
  11846. Insert STRING on each line of the region-rectangle, shifting text right.
  11847. The left edge of the rectangle specifies the column for insertion.
  11848. This command does not delete or overwrite any existing text.
  11849.  
  11850. Called from a program, takes three args; START, END and STRING.Fclear-rectangle
  11851. Blank out rectangle with corners at point and mark.
  11852. The text previously in the region is overwritten by the blanks.
  11853. When called from a program, requires two args which specify the corners.Vmail-user-agent
  11854. *Your preference for a mail composition package.
  11855. Various Emacs Lisp packages (e.g. reporter) require you to compose an
  11856. outgoing email message.  As there are several such packages available
  11857. for Emacs, you can indicate your preference by setting this variable.
  11858.  
  11859. Valid values currently are:
  11860.  
  11861.     'sendmail-user-agent -- use Emacs built-in Mail package
  11862.     'vm-user-agent       -- use Kyle Jones' VM package
  11863.     'mh-e-user-agent     -- use the Emacs interface to the MH mail system
  11864.  
  11865. Additional valid symbols may be available; check with the author of
  11866. your package for details.Freposition-window
  11867. Make the current definition and/or comment visible.
  11868. Further invocations move it to the top of the window or toggle the
  11869. visibility of comments that precede it.
  11870.   Point is left unchanged unless prefix ARG is supplied.
  11871.   If the definition is fully onscreen, it is moved to the top of the
  11872. window.  If it is partly offscreen, the window is scrolled to get the
  11873. definition (or as much as will fit) onscreen, unless point is in a comment
  11874. which is also partly offscreen, in which case the scrolling attempts to get
  11875. as much of the comment onscreen as possible.
  11876.   Initially `reposition-window' attempts to make both the definition and
  11877. preceding comments visible.  Further invocations toggle the visibility of
  11878. the comment lines.
  11879.   If ARG is non-nil, point may move in order to make the whole defun
  11880. visible (if only part could otherwise be made so), to make the defun line
  11881. visible (if point is in code and it could not be made so, or if only
  11882. comments, including the first comment line, are visible), or to make the
  11883. first comment line visible (if point is in a comment).Fresume-suspend-hook
  11884. Clear out the file used for transmitting args when Emacs resumes.Fring-p
  11885. Returns t if X is a ring; nil otherwise.Fmake-ring
  11886. Make a ring that can contain SIZE elements.Frlogin
  11887. Open a network login connection via `rlogin' with args INPUT-ARGS.
  11888. INPUT-ARGS should start with a host name; it may also contain
  11889. other arguments for `rlogin'.
  11890.  
  11891. Input is sent line-at-a-time to the remote connection.
  11892.  
  11893. Communication with the remote host is recorded in a buffer `*rlogin-HOST*'
  11894. (or `*rlogin-USER@HOST*' if the remote username differs).
  11895. If a prefix argument is given and the buffer `*rlogin-HOST*' already exists,
  11896. a new buffer with a different connection will be made.
  11897.  
  11898. When called from a program, if the optional second argument BUFFER is
  11899. a string or buffer, it specifies the buffer to use.
  11900.  
  11901. The variable `rlogin-program' contains the name of the actual program to
  11902. run.  It can be a relative or absolute path.
  11903.  
  11904. The variable `rlogin-explicit-args' is a list of arguments to give to
  11905. the rlogin when starting.  They are added after any arguments given in
  11906. INPUT-ARGS.
  11907.  
  11908. If the default value of `rlogin-directory-tracking-mode' is t, then the
  11909. default directory in that buffer is set to a remote (FTP) file name to
  11910. access your home directory on the remote machine.  Occasionally this causes
  11911. an error, if you cannot access the home directory on that machine.  This
  11912. error is harmless as long as you don't try to use that default directory.
  11913.  
  11914. If `rlogin-directory-tracking-mode' is neither t nor nil, then the default
  11915. directory is initially set up to your (local) home directory.
  11916. This is useful if the remote machine and your local machine
  11917. share the same files via NFS.  This is the default.
  11918.  
  11919. If you wish to change directory tracking styles during a session, use the
  11920. function `rlogin-directory-tracking-mode' rather than simply setting the
  11921. variable.Vrmail-dont-reply-to-names
  11922. *A regexp specifying names to prune of reply to messages.
  11923. A value of nil means exclude your own name only.Vrmail-default-dont-reply-to-names
  11924. A regular expression specifying part of the value of the default value of
  11925. the variable `rmail-dont-reply-to-names', for when the user does not set
  11926. `rmail-dont-reply-to-names' explicitly.  (The other part of the default
  11927. value is the user's name.)
  11928. It is useful to set this variable in the site customization file.Vrmail-ignored-headers
  11929. *Regexp to match Header fields that Rmail should normally hide.Vrmail-displayed-headers
  11930. *Regexp to match Header fields that Rmail should display.
  11931. If nil, display all header fields except those matched by
  11932. `rmail-ignored-headers'.Vrmail-retry-ignored-headers
  11933. *Headers that should be stripped when retrying a failed message.Vrmail-highlighted-headers
  11934. *Regexp to match Header fields that Rmail should normally highlight.
  11935. A value of nil means don't highlight.
  11936. See also `rmail-highlight-face'.Vrmail-highlight-face
  11937. *Face used by Rmail for highlighting headers.Vrmail-delete-after-output
  11938. *Non-nil means automatically delete a message that is copied to a file.Vrmail-primary-inbox-list
  11939. *List of files which are inboxes for user's primary mail file `~/RMAIL'.
  11940. `nil' means the default, which is ("/usr/spool/mail/$USER")
  11941. (the name varies depending on the operating system,
  11942. and the value of the environment variable MAIL overrides it).Vrmail-mail-new-frame
  11943. *Non-nil means Rmail makes a new frame for composing outgoing mail.Vrmail-secondary-file-directory
  11944. *Directory for additional secondary Rmail files.Vrmail-secondary-file-regexp
  11945. *Regexp for which files are secondary Rmail files.Vrmail-mode-hook
  11946. List of functions to call when Rmail is invoked.Vrmail-get-new-mail-hook
  11947. List of functions to call when Rmail has retrieved new mail.Vrmail-show-message-hook
  11948. List of functions to call when Rmail displays a message.Vrmail-delete-message-hook
  11949. List of functions to call when Rmail deletes a message.
  11950. When the hooks are called, the message has been marked deleted but is
  11951. still the current message in the Rmail buffer.Frmail
  11952. Read and edit incoming mail.
  11953. Moves messages into file named by `rmail-file-name' (a babyl format file)
  11954.  and edits that file in RMAIL Mode.
  11955. Type \[describe-mode] once editing that file, for a list of RMAIL commands.
  11956.  
  11957. May be called with file name as argument; then performs rmail editing on
  11958. that file, but does not copy any new mail into the file.
  11959. Interactively, if you supply a prefix argument, then you
  11960. have a chance to specify a file name with the minibuffer.
  11961.  
  11962. If `rmail-display-summary' is non-nil, make a summary for this RMAIL file.Frmail-mode
  11963. Rmail Mode is used by \<rmail-mode-map>\[rmail] for editing Rmail files.
  11964. All normal editing commands are turned off.
  11965. Instead, these commands are available:
  11966.  
  11967. \[rmail-beginning-of-message]    Move point to front of this message (same as \[beginning-of-buffer]).
  11968. \[scroll-up]    Scroll to next screen of this message.
  11969. \[scroll-down]    Scroll to previous screen of this message.
  11970. \[rmail-next-undeleted-message]    Move to Next non-deleted message.
  11971. \[rmail-previous-undeleted-message]    Move to Previous non-deleted message.
  11972. \[rmail-next-message]    Move to Next message whether deleted or not.
  11973. \[rmail-previous-message]    Move to Previous message whether deleted or not.
  11974. \[rmail-first-message]    Move to the first message in Rmail file.
  11975. \[rmail-last-message]    Move to the last message in Rmail file.
  11976. \[rmail-show-message]    Jump to message specified by numeric position in file.
  11977. \[rmail-search]    Search for string and show message it is found in.
  11978. \[rmail-delete-forward]    Delete this message, move to next nondeleted.
  11979. \[rmail-delete-backward]    Delete this message, move to previous nondeleted.
  11980. \[rmail-undelete-previous-message]    Undelete message.  Tries current message, then earlier messages
  11981.     till a deleted message is found.
  11982. \[rmail-edit-current-message]    Edit the current message.  \[rmail-cease-edit] to return to Rmail.
  11983. \[rmail-expunge]    Expunge deleted messages.
  11984. \[rmail-expunge-and-save]    Expunge and save the file.
  11985. \[rmail-quit]       Quit Rmail: expunge, save, then switch to another buffer.
  11986. \[save-buffer] Save without expunging.
  11987. \[rmail-get-new-mail]    Move new mail from system spool directory into this file.
  11988. \[rmail-mail]    Mail a message (same as \[mail-other-window]).
  11989. \[rmail-continue]    Continue composing outgoing message started before.
  11990. \[rmail-reply]    Reply to this message.  Like \[rmail-mail] but initializes some fields.
  11991. \[rmail-retry-failure]    Send this message again.  Used on a mailer failure message.
  11992. \[rmail-forward]    Forward this message to another user.
  11993. \[rmail-output-to-rmail-file]       Output this message to an Rmail file (append it).
  11994. \[rmail-output]    Output this message to a Unix-format mail file (append it).
  11995. \[rmail-input]    Input Rmail file.  Run Rmail on that file.
  11996. \[rmail-add-label]    Add label to message.  It will be displayed in the mode line.
  11997. \[rmail-kill-label]    Kill label.  Remove a label from current message.
  11998. \[rmail-next-labeled-message]   Move to Next message with specified label
  11999.           (label defaults to last one specified).
  12000.           Standard labels: filed, unseen, answered, forwarded, deleted.
  12001.           Any other label is present only if you add it with \[rmail-add-label].
  12002. \[rmail-previous-labeled-message]   Move to Previous message with specified label
  12003. \[rmail-summary]    Show headers buffer, with a one line summary of each message.
  12004. \[rmail-summary-by-labels]    Summarize only messages with particular label(s).
  12005. \[rmail-summary-by-recipients]   Summarize only messages with particular recipient(s).
  12006. \[rmail-summary-by-regexp]   Summarize only messages with particular regexp(s).
  12007. \[rmail-summary-by-topic]   Summarize only messages with subject line regexp(s).
  12008. \[rmail-toggle-header]    Toggle display of complete header.Frmail-input
  12009. Run Rmail on file FILENAME.Vrmail-summary-scroll-between-messages
  12010. *Non-nil means Rmail summary scroll commands move between messages.Fnews-post-news
  12011. Begin editing a new USENET news article to be posted.
  12012. Type \[describe-mode] once editing the article to get a list of commands.Frot13-other-window
  12013. Display current buffer in rot 13 in another window.
  12014. To terminate the rot13 display, delete that window.Ftoggle-rot13-mode
  12015. Toggle the use of rot 13 encoding for the current window.Vresize-minibuffer-mode
  12016. *If non-`nil', resize the minibuffer so its entire contents are visible.Vresize-minibuffer-window-max-height
  12017. *Maximum size the minibuffer window is allowed to become.
  12018. If less than 1 or not a number, the limit is the height of the frame in
  12019. which the active minibuffer window resides.Vresize-minibuffer-window-exactly
  12020. *Allow making minibuffer exactly the size to display all its contents.
  12021. If `nil', the minibuffer window can temporarily increase in size but
  12022. never get smaller while it is active.  Any other value allows exact
  12023. resizing.Vresize-minibuffer-frame
  12024. *Allow changing the frame height of minibuffer frames.
  12025. If non-`nil' and the active minibuffer is the sole window in its frame,
  12026. allow changing the frame height.Vresize-minibuffer-frame-max-height
  12027. *Maximum size the minibuffer frame is allowed to become.
  12028. If less than 1 or not a number, there is no limit.Vresize-minibuffer-frame-exactly
  12029. *Allow making minibuffer frame exactly the size to display all its contents.
  12030. If `nil', the minibuffer frame can temporarily increase in size but
  12031. never get smaller while it is active.  Any other value allows exact
  12032. resizing.Fresize-minibuffer-mode
  12033. Enable or disable resize-minibuffer mode.
  12034. A negative prefix argument disables this mode.  A positive argument or
  12035. argument of 0 enables it.
  12036.  
  12037. When this minor mode is enabled, the minibuffer is dynamically resized to
  12038. contain the entire region of text put in it as you type.
  12039.  
  12040. The variable `resize-minibuffer-mode' is set to t or nil depending on
  12041. whether this mode is active or not.
  12042.  
  12043. The maximum height to which the minibuffer can grow is controlled by the
  12044. variable `resize-minibuffer-window-max-height'.
  12045.  
  12046. The variable `resize-minibuffer-window-exactly' determines whether the
  12047. minibuffer window should ever be shrunk to make it no larger than needed to
  12048. display its contents.
  12049.  
  12050. When using a window system, it is possible for a minibuffer to be the sole
  12051. window in a frame.  Since that window is already its maximum size, the only
  12052. way to make more text visible at once is to increase the size of the frame.
  12053. The variable `resize-minibuffer-frame' controls whether this should be
  12054. done.  The variables `resize-minibuffer-frame-max-height' and
  12055. `resize-minibuffer-frame-exactly' are analogous to their window
  12056. counterparts.Fscheme-mode
  12057. Major mode for editing Scheme code.
  12058. Editing commands are similar to those of lisp-mode.
  12059.  
  12060. In addition, if an inferior Scheme process is running, some additional
  12061. commands will be defined, for evaluating expressions and controlling
  12062. the interpreter, and the state of the process will be displayed in the
  12063. modeline of all Scheme buffers.  The names of commands that interact
  12064. with the Scheme process start with "xscheme-".  For more information
  12065. see the documentation for xscheme-interaction-mode.
  12066.  
  12067. Commands:
  12068. Delete converts tabs to spaces as it moves back.
  12069. Blank lines separate paragraphs.  Semicolons start comments.
  12070. \{scheme-mode-map}
  12071. Entry to this mode calls the value of scheme-mode-hook
  12072. if that value is non-nil.Fgnus-score-mode
  12073. Mode for editing Gnus score files.
  12074. This mode is an extended emacs-lisp mode.
  12075.  
  12076. \{gnus-score-mode-map}Fscribe-mode
  12077. Major mode for editing files of Scribe (a text formatter) source.
  12078. Scribe-mode is similar text-mode, with a few extra commands added.
  12079. \{scribe-mode-map}
  12080.  
  12081. Interesting variables:
  12082.  
  12083. scribe-fancy-paragraphs
  12084.   Non-nil makes Scribe mode use a different style of paragraph separation.
  12085.  
  12086. scribe-electric-quote
  12087.   Non-nil makes insert of double quote use `` or '' depending on context.
  12088.  
  12089. scribe-electric-parenthesis
  12090.   Non-nil makes an open-parenthesis char (one of `([<{')
  12091.   automatically insert its close if typed after an @Command form.Vmail-from-style
  12092. *Specifies how "From:" fields look.
  12093.  
  12094. If `nil', they contain just the return address like:
  12095.     king@grassland.com
  12096. If `parens', they look like:
  12097.     king@grassland.com (Elvis Parsley)
  12098. If `angles', they look like:
  12099.     Elvis Parsley <king@grassland.com>Vmail-self-blind
  12100. Non-nil means insert BCC to self in messages to be sent.
  12101. This is done when the message is initialized,
  12102. so you can remove or alter the BCC field to override the default.Vmail-interactive
  12103. Non-nil means when sending a message wait for and display errors.
  12104. nil means let mailer mail back a message to report errors.Vmail-yank-ignored-headers
  12105. Delete these headers from old message when it's inserted in a reply.Vsend-mail-function
  12106. Function to call to send the current buffer as mail.
  12107. The headers should be delimited by a line whose contents
  12108. match the variable `mail-header-separator'.Vmail-header-separator
  12109. *Line used to separate headers from text in messages being composed.Vmail-archive-file-name
  12110. *Name of file to write all outgoing messages in, or nil for none.
  12111. This can be an inbox file or an Rmail file.Vmail-default-reply-to
  12112. *Address to insert as default Reply-to field of outgoing messages.
  12113. If nil, it will be initialized from the REPLYTO environment variable
  12114. when you first send mail.Vmail-alias-file
  12115. *If non-nil, the name of a file to use instead of `/usr/lib/aliases'.
  12116. This file defines aliases to be expanded by the mailer; this is a different
  12117. feature from that of defining aliases in `.mailrc' to be expanded in Emacs.
  12118. This variable has no effect unless your system uses sendmail as its mailer.Vmail-personal-alias-file
  12119. *If non-nil, the name of the user's personal mail alias file.
  12120. This file typically should be in same format as the `.mailrc' file used by
  12121. the `Mail' or `mailx' program.
  12122. This file need not actually exist.Vmail-signature
  12123. *Text inserted at end of mail buffer when a message is initialized.
  12124. If t, it means to insert the contents of the file `mail-signature-file'.Fmail-mode
  12125. Major mode for editing mail to be sent.
  12126. Like Text Mode but with these additional commands:
  12127. C-c C-s  mail-send (send the message)    C-c C-c  mail-send-and-exit
  12128. C-c C-f  move to a header field (and create it if there isn't):
  12129.      C-c C-f C-t  move to To:    C-c C-f C-s  move to Subject:
  12130.      C-c C-f C-c  move to CC:    C-c C-f C-b  move to BCC:
  12131.      C-c C-f C-f  move to FCC:
  12132. C-c C-t  mail-text (move to beginning of message text).
  12133. C-c C-w  mail-signature (insert `mail-signature-file' file).
  12134. C-c C-y  mail-yank-original (insert current message, in Rmail).
  12135. C-c C-q  mail-fill-yanked-message (fill what was yanked).
  12136. C-c C-v  mail-sent-via (add a Sent-via field for each To or CC).Fmail
  12137. Edit a message to be sent.  Prefix arg means resume editing (don't erase).
  12138. When this function returns, the buffer `*mail*' is selected.
  12139. The value is t if the message was newly initialized; otherwise, nil.
  12140.  
  12141. Optionally, the signature file `mail-signature-file' can be inserted at the
  12142. end; see the variable `mail-signature'.
  12143.  
  12144. \<mail-mode-map>
  12145. While editing message, type \[mail-send-and-exit] to send the message and exit.
  12146.  
  12147. Various special commands starting with C-c are available in sendmail mode
  12148. to move to message header fields:
  12149. \{mail-mode-map}
  12150.  
  12151. If `mail-self-blind' is non-nil, a BCC to yourself is inserted
  12152. when the message is initialized.
  12153.  
  12154. If `mail-default-reply-to' is non-nil, it should be an address (a string);
  12155. a Reply-to: field with that address is inserted.
  12156.  
  12157. If `mail-archive-file-name' is non-nil, an FCC field with that file name
  12158. is inserted.
  12159.  
  12160. The normal hook `mail-setup-hook' is run after the message is
  12161. initialized.  It can add more default fields to the message.
  12162.  
  12163. When calling from a program, the first argument if non-nil says
  12164. not to erase the existing contents of the `*mail*' buffer.
  12165.  
  12166. The second through fifth arguments,
  12167.  TO, SUBJECT, IN-REPLY-TO and CC, specify if non-nil
  12168.  the initial contents of those header fields.
  12169.  These arguments should not have final newlines.
  12170. The sixth argument REPLYBUFFER is a buffer whose contents
  12171.  should be yanked if the user types C-c C-y.
  12172. The seventh argument ACTIONS is a list of actions to take
  12173.  if/when the message is sent.  Each action looks like (FUNCTION . ARGS);
  12174.  when the message is sent, we apply FUNCTION to ARGS.
  12175.  This is how Rmail arranges to mark messages `answered'.Fmail-other-window
  12176. Like `mail' command, but display mail buffer in another window.Fmail-other-frame
  12177. Like `mail' command, but display mail buffer in another frame.Fserver-start
  12178. Allow this Emacs process to be a server for client processes.
  12179. This starts a server communications subprocess through which
  12180. client "editors" can send your editing commands to this Emacs job.
  12181. To use the server, set up the program `emacsclient' in the
  12182. Emacs distribution as your standard "editor".
  12183.  
  12184. Prefix arg means just kill any existing server communications subprocess.Fsgml-mode
  12185. Major mode for editing SGML documents.
  12186. Makes > match <.  Makes / blink matching /.
  12187. Keys <, &, SPC within <>, " and ' can be electric depending on
  12188. `sgml-quick-keys'.
  12189.  
  12190. Do \[describe-variable] sgml- SPC to see available variables.
  12191.  
  12192. Use \[sgml-validate] to validate your document with an SGML parser.
  12193. \{sgml-mode-map}Fhtml-mode
  12194. Major mode based on SGML mode for editing HTML documents.
  12195. This allows inserting skeleton costructs used in hypertext documents with
  12196. completion.  See below for an introduction to HTML.  Use
  12197. \[browse-url-of-buffer] to see how this comes out.  See also `sgml-mode' on
  12198. which this is based.
  12199.  
  12200. Do \[describe-variable] html- SPC and \[describe-variable] sgml- SPC to see available variables.
  12201.  
  12202. To write fairly well formatted pages you only need to know few things.  Most
  12203. browsers have a function to read the source code of the page being seen, so
  12204. you can imitate various tricks.  Here's a very short HTML primer which you
  12205. can also view with a browser to see what happens:
  12206.  
  12207. <title>A Title Describing Contents</title> should be on every page.  Pages can
  12208. have <h1>Very Major Headlines</h1> through <h6>Very Minor Headlines</h6>
  12209. <hr> Parts can be separated with horizontal rules.
  12210.  
  12211. <p>Paragraphs only need an opening tag.  Line breaks and multiple spaces are
  12212. ignored unless the text is <pre>preformatted.</pre>  Text can be marked as
  12213. <b>bold</b>, <i>italic</i> or <u>underlined</u> using the normal  M-g  or
  12214. Edit/Text Properties/Face commands.
  12215.  
  12216. Pages can have <a name="SOMENAME">named points</a> and can link other points
  12217. to them with <a href="#SOMENAME">see also somename</a>.  In the same way <a
  12218. href="URL">see also URL</a> where URL is a filename relative to current
  12219. directory or something like http://www.cs.indiana.edu/elisp/w3/docs.html.
  12220.  
  12221. Images in many formats can be inlined with <img src="URL">.
  12222.  
  12223. If you mainly create your own documents, `sgml-specials' might be interesting.
  12224. But note that some HTML 2 browsers can't handle '.  To work around that
  12225. do:
  12226.  
  12227. (eval-after-load "sgml-mode" '(aset sgml-char-names ?' nil))
  12228. \{html-mode-map}Fsh-mode
  12229. Major mode for editing shell scripts.
  12230. This mode works for many shells, since they all have roughly the same syntax,
  12231. as far as commands, arguments, variables, pipes, comments etc. are concerned.
  12232. Unless the file's magic number indicates the shell, your usual shell is
  12233. assumed.  Since filenames rarely give a clue, they are not further analyzed.
  12234.  
  12235. This mode adapts to the variations between shells (see `sh-set-shell') by
  12236. means of an inheritance based feature lookup (see `sh-feature').  This
  12237. mechanism applies to all variables (including skeletons) that pertain to
  12238. shell-specific features.
  12239.  
  12240. The default style of this mode is that of Rosenblatt's Korn shell book.
  12241. The syntax of the statements varies with the shell being used.  The
  12242. following commands are available, based on the current shell's syntax:
  12243.  
  12244. \[sh-case]     case statement
  12245. \[sh-for]     for loop
  12246. \[sh-function]     function definition
  12247. \[sh-if]     if statement
  12248. \[sh-indexed-loop]     indexed loop from 1 to n
  12249. \[sh-while-getopts]     while getopts loop
  12250. \[sh-repeat]     repeat loop
  12251. \[sh-select]     select loop
  12252. \[sh-until]     until loop
  12253. \[sh-while]     while loop
  12254.  
  12255. \[backward-delete-char-untabify]     Delete backward one position, even if it was a tab.
  12256. \[sh-newline-and-indent]     Delete unquoted space and indent new line same as this one.
  12257. \[sh-end-of-command]     Go to end of successive commands.
  12258. \[sh-beginning-of-command]     Go to beginning of successive commands.
  12259. \[sh-set-shell]     Set this buffer's shell, and maybe its magic number.
  12260. \[sh-execute-region]     Have optional header and region be executed in a subshell.
  12261.  
  12262. \[sh-maybe-here-document]     Without prefix, following an unquoted < inserts here document.
  12263. {, (, [, ', ", `
  12264.     Unless quoted with \, insert the pairs {}, (), [], or '', "", ``.
  12265.  
  12266. If you generally program a shell different from your login shell you can
  12267. set `sh-shell-file' accordingly.  If your shell's file name doesn't correctly
  12268. indicate what shell it is use `sh-alias-alist' to translate.
  12269.  
  12270. If your shell gives error messages with line numbers, you can use \[executable-interpret]
  12271. with your script for an edit-interpret-debug cycle.Flist-load-path-shadows
  12272. Display a list of Emacs Lisp files that shadow other files.
  12273.  
  12274. This function lists potential load-path problems.  Directories in the
  12275. `load-path' variable are searched, in order, for Emacs Lisp
  12276. files.  When a previously encountered file name is found again, a
  12277. message is displayed indicating that the later file is "hidden" by
  12278. the earlier.
  12279.  
  12280. For example, suppose `load-path' is set to
  12281.  
  12282. ("/usr/gnu/emacs/site-lisp" "/usr/gnu/emacs/share/emacs/19.30/lisp")
  12283.  
  12284. and that each of these directories contains a file called XXX.el.  Then
  12285. XXX.el in the site-lisp directory is referred to by all of:
  12286. (require 'XXX), (autoload .... "XXX"), (load-library "XXX") etc.
  12287.  
  12288. The first XXX.el file prevents emacs from seeing the second (unless
  12289. the second is loaded explicitly via load-file).
  12290.  
  12291. When not intended, such shadowings can be the source of subtle
  12292. problems.  For example, the above situation may have arisen because the
  12293. XXX package was not distributed with versions of emacs prior to
  12294. 19.30.  An emacs maintainer downloaded XXX from elsewhere and installed
  12295. it.  Later, XXX was updated and included in the emacs distribution.
  12296. Unless the emacs maintainer checks for this, the new version of XXX
  12297. will be hidden behind the old (which may no longer work with the new
  12298. emacs version).
  12299.  
  12300. This function performs these checks and flags all possible
  12301. shadowings.  Because a .el file may exist without a corresponding .elc
  12302. (or vice-versa), these suffixes are essentially ignored.  A file
  12303. XXX.elc in an early directory (that does not contain XXX.el) is
  12304. considered to shadow a later file XXX.el, and vice-versa.
  12305.  
  12306. When run interactively, the shadowings (if any) are displayed in a
  12307. buffer called `*Shadows*'.  Shadowings are located by calling the
  12308. (non-interactive) companion function, `find-emacs-lisp-shadows'.Vshell-prompt-pattern
  12309. Regexp to match prompts in the inferior shell.
  12310. Defaults to "^[^#$%>\n]*[#$%>] *", which works pretty well.
  12311. This variable is used to initialise `comint-prompt-regexp' in the 
  12312. shell buffer.
  12313.  
  12314. The pattern should probably not match more than one line.  If it does,
  12315. Shell mode may become confused trying to distinguish prompt from input
  12316. on lines which don't start with a prompt.
  12317.  
  12318. This is a fine thing to set in your `.emacs' file.Fshell
  12319. Run an inferior shell, with I/O through buffer *shell*.
  12320. If buffer exists but shell process is not running, make new shell.
  12321. If buffer exists and shell process is running, just switch to buffer `*shell*'.
  12322. Program used comes from variable `explicit-shell-file-name',
  12323.  or (if that is nil) from the ESHELL environment variable,
  12324.  or else from SHELL if there is no ESHELL.
  12325. If a file `~/.emacs_SHELLNAME' exists, it is given as initial input
  12326.  (Note that this may lose due to a timing error if the shell
  12327.   discards input when it starts up.)
  12328. The buffer is put in Shell mode, giving commands for sending input
  12329. and controlling the subjobs of the shell.  See `shell-mode'.
  12330. See also the variable `shell-prompt-pattern'.
  12331.  
  12332. The shell file name (sans directories) is used to make a symbol name
  12333. such as `explicit-csh-args'.  If that symbol is a variable,
  12334. its value is used as a list of arguments when invoking the shell.
  12335. Otherwise, one argument `-i' is passed to the shell.
  12336.  
  12337. (Type \[describe-mode] in the shell buffer for a list of commands.)Vskeleton-filter
  12338. Function for transforming a skeleton proxy's aliases' variable value.Fdefine-skeleton
  12339. Define a user-configurable COMMAND that enters a statement skeleton.
  12340. DOCUMENTATION is that of the command, while the variable of the same name,
  12341. which contains the skeleton, has a documentation to that effect.
  12342. INTERACTOR and ELEMENT ... are as defined under `skeleton-insert'.Fskeleton-proxy-new
  12343. Insert skeleton defined by variable of same name (see `skeleton-insert').
  12344. Prefix ARG allows wrapping around words or regions (see `skeleton-insert').
  12345. If no ARG was given, but the region is visible, ARG defaults to -1 depending
  12346. on `skeleton-autowrap'.  An ARG of  M-0  will prevent this just for once.
  12347. This command can also be an abbrev expansion (3rd and 4th columns in
  12348. \[edit-abbrevs]  buffer: ""  command-name).
  12349.  
  12350. When called as a function, optional first argument STR may also be a string
  12351. which will be the value of `str' whereas the skeleton's interactor is then
  12352. ignored.Fskeleton-proxy
  12353. Insert skeleton defined by variable of same name (see `skeleton-insert').
  12354. Prefix ARG allows wrapping around words or regions (see `skeleton-insert').
  12355. If no ARG was given, but the region is visible, ARG defaults to -1 depending
  12356. on `skeleton-autowrap'.  An ARG of  M-0  will prevent this just for once.
  12357. This command can also be an abbrev expansion (3rd and 4th columns in
  12358. \[edit-abbrevs]  buffer: ""  command-name).
  12359.  
  12360. When called as a function, optional first argument STR may also be a string
  12361. which will be the value of `str' whereas the skeleton's interactor is then
  12362. ignored.Fskeleton-insert
  12363. Insert the complex statement skeleton SKELETON describes very concisely.
  12364.  
  12365. With optional third REGIONS wrap first interesting point (`_') in skeleton
  12366. around next REGIONS words, if REGIONS is positive.  If REGIONS is negative,
  12367. wrap REGIONS preceding interregions into first REGIONS interesting positions
  12368. (successive `_'s) in skeleton.  An interregion is the stretch of text between
  12369. two contiguous marked points.  If you marked A B C [] (where [] is the cursor)
  12370. in alphabetical order, the 3 interregions are simply the last 3 regions.  But
  12371. if you marked B A [] C, the interregions are B-A, A-[], []-C.
  12372.  
  12373. Optional fourth STR is the value for the variable `str' within the skeleton.
  12374. When this is non-`nil' the interactor gets ignored, and this should be a valid
  12375. skeleton element.
  12376.  
  12377. SKELETON is made up as (INTERACTOR ELEMENT ...).  INTERACTOR may be nil if
  12378. not needed, a prompt-string or an expression for complex read functions.
  12379.  
  12380. If ELEMENT is a string or a character it gets inserted (see also
  12381. `skeleton-transformation').  Other possibilities are:
  12382.  
  12383.     \n    go to next line and indent according to mode
  12384.     _    interesting point, interregion here, point after termination
  12385.     >    indent line (or interregion if > _) according to major mode
  12386.     &    do next ELEMENT if previous moved point
  12387.     |    do next ELEMENT if previous didn't move point
  12388.     -num    delete num preceding characters (see `skeleton-untabify')
  12389.     resume:    skipped, continue here if quit is signaled
  12390.     nil    skipped
  12391.  
  12392. Further elements can be defined via `skeleton-further-elements'.  ELEMENT may
  12393. itself be a SKELETON with an INTERACTOR.  The user is prompted repeatedly for
  12394. different inputs.  The SKELETON is processed as often as the user enters a
  12395. non-empty string.  \[keyboard-quit] terminates skeleton insertion, but
  12396. continues after `resume:' and positions at `_' if any.  If INTERACTOR in such
  12397. a subskeleton is a prompt-string which contains a ".. %s .." it is
  12398. formatted with `skeleton-subprompt'.  Such an INTERACTOR may also a list of
  12399. strings with the subskeleton being repeated once for each string.
  12400.  
  12401. Quoted Lisp expressions are evaluated evaluated for their side-effect.
  12402. Other Lisp expressions are evaluated and the value treated as above.
  12403. Note that expressions may not return `t' since this implies an
  12404. endless loop.  Modes can define other symbols by locally setting them
  12405. to any valid skeleton element.  The following local variables are
  12406. available:
  12407.  
  12408.     str    first time: read a string according to INTERACTOR
  12409.         then: insert previously read string once more
  12410.     help    help-form during interaction with the user or `nil'
  12411.     input    initial input (string or cons with index) while reading str
  12412.     v1, v2    local variables for memorizing anything you want
  12413.  
  12414. When done with skeleton, but before going back to `_'-point call
  12415. `skeleton-end-hook' if that is non-`nil'.Fskeleton-pair-insert-maybe
  12416. Insert the character you type ARG times.
  12417.  
  12418. With no ARG, if `skeleton-pair' is non-nil, pairing can occur.  If the region
  12419. is visible the pair is wrapped around it depending on `skeleton-autowrap'.
  12420. Else, if `skeleton-pair-on-word' is non-nil or we are not before or inside a
  12421. word, and if `skeleton-pair-filter' returns nil, pairing is performed.
  12422.  
  12423. If a match is found in `skeleton-pair-alist', that is inserted, else
  12424. the defaults are used.  These are (), [], {}, <> and `' for the
  12425. symmetrical ones, and the same character twice for the others.Vcalendar-time-display-form
  12426. *The pseudo-pattern that governs the way a time of day is formatted.
  12427.  
  12428. A pseudo-pattern is a list of expressions that can involve the keywords
  12429. `12-hours', `24-hours', and `minutes',  all numbers in string form,
  12430. and `am-pm' and `time-zone',  both alphabetic strings.
  12431.  
  12432. For example, the form
  12433.  
  12434.   '(24-hours ":" minutes
  12435.     (if time-zone " (") time-zone (if time-zone ")"))
  12436.  
  12437. would give military-style times like `21:07 (UTC)'.Vcalendar-latitude
  12438. *Latitude of `calendar-location-name' in degrees.
  12439.  
  12440. The value can be either a decimal fraction (one place of accuracy is
  12441. sufficient), + north, - south, such as 40.7 for New York City, or the value
  12442. can be a vector [degrees minutes north/south] such as [40 50 north] for New
  12443. York City.
  12444.  
  12445. This variable should be set in `site-start'.el.Vcalendar-longitude
  12446. *Longitude of `calendar-location-name' in degrees.
  12447.  
  12448. The value can be either a decimal fraction (one place of accuracy is
  12449. sufficient), + east, - west, such as -73.9 for New York City, or the value
  12450. can be a vector [degrees minutes east/west] such as [73 55 west] for New
  12451. York City.
  12452.  
  12453. This variable should be set in `site-start'.el.Vcalendar-location-name
  12454. *Expression evaluating to name of `calendar-longitude', calendar-latitude'.
  12455. For example, "New York City".  Default value is just the latitude, longitude
  12456. pair.
  12457.  
  12458. This variable should be set in `site-start'.el.Fsunrise-sunset
  12459. Local time of sunrise and sunset for today.  Accurate to a few seconds.
  12460. If called with an optional prefix argument, prompt for date.
  12461.  
  12462. If called with an optional double prefix argument, prompt for longitude,
  12463. latitude, time zone, and date, and always use standard time.
  12464.  
  12465. This function is suitable for execution in a .emacs file.Fsolar-equinoxes-solstices
  12466. *local* date and time of equinoxes and solstices, if visible in the calendar window.
  12467. Requires floating point.Fsolitaire
  12468. Play Solitaire.
  12469.  
  12470. To play Solitaire, type \[solitaire].
  12471. \<solitaire-mode-map>
  12472. Move around the board using the cursor keys.
  12473. Move stones using \[solitaire-move] followed by a direction key.
  12474. Undo moves using \[solitaire-undo].
  12475. Check for possible moves using \[solitaire-do-check].
  12476. (The variable solitaire-auto-eval controls whether to automatically
  12477. check after each move or undo)
  12478.  
  12479. What is Solitaire?
  12480.  
  12481. I don't know who invented this game, but it seems to be rather old and
  12482. it's origin seems be northern Africa.  Here's how to play:
  12483. Initially, the board will look similar to this:
  12484.  
  12485.     Le Solitaire             
  12486.     ============             
  12487.     
  12488.         o   o   o        
  12489.     
  12490.         o   o   o        
  12491.     
  12492.     o   o   o   o   o   o   o
  12493.     
  12494.     o   o   o   .   o   o   o
  12495.     
  12496.     o   o   o   o   o   o   o
  12497.     
  12498.         o   o   o        
  12499.     
  12500.         o   o   o        
  12501.  
  12502. Let's call the o's stones and the .'s holes.  One stone fits into one
  12503. hole.  As you can see, all holes but one are occupied by stones.  The
  12504. aim of the game is to get rid of all but one stone, leaving that last
  12505. one in the middle of the board if you're cool.
  12506.  
  12507. A stone can be moved if there is another stone next to it, and a hole
  12508. after that one.  Thus there must be three fields in a row, either
  12509. horizontally or vertically, up, down, left or right, which look like
  12510. this:  o  o  .
  12511.  
  12512. Then the first stone is moved to the hole, jumping over the second,
  12513. which therefore is taken away.  The above thus `evaluates' to:  .  .  o
  12514.  
  12515. That's all.  Here's the board after two moves:
  12516.  
  12517.         o   o   o        
  12518.     
  12519.         .   o   o        
  12520.     
  12521.     o   o   .   o   o   o   o
  12522.     
  12523.     o   .   o   o   o   o   o
  12524.     
  12525.     o   o   o   o   o   o   o
  12526.     
  12527.         o   o   o        
  12528.     
  12529.         o   o   o
  12530.  
  12531. Pick your favourite shortcuts:
  12532.  
  12533. \{solitaire-mode-map}Fsort-subr
  12534. General text sorting routine to divide buffer into records and sort them.
  12535. Arguments are REVERSE NEXTRECFUN ENDRECFUN &optional STARTKEYFUN ENDKEYFUN.
  12536.  
  12537. We divide the accessible portion of the buffer into disjoint pieces
  12538. called sort records.  A portion of each sort record (perhaps all of
  12539. it) is designated as the sort key.  The records are rearranged in the
  12540. buffer in order by their sort keys.  The records may or may not be
  12541. contiguous.
  12542.  
  12543. Usually the records are rearranged in order of ascending sort key.
  12544. If REVERSE is non-nil, they are rearranged in order of descending sort key.
  12545.  
  12546. The next four arguments are functions to be called to move point
  12547. across a sort record.  They will be called many times from within sort-subr.
  12548.  
  12549. NEXTRECFUN is called with point at the end of the previous record.
  12550. It moves point to the start of the next record.
  12551. It should move point to the end of the buffer if there are no more records.
  12552. The first record is assumed to start at the position of point when sort-subr
  12553. is called.
  12554.  
  12555. ENDRECFUN is called with point within the record.
  12556. It should move point to the end of the record.
  12557.  
  12558. STARTKEYFUN moves from the start of the record to the start of the key.
  12559. It may return either a non-nil value to be used as the key, or
  12560. else the key is the substring between the values of point after
  12561. STARTKEYFUN and ENDKEYFUN are called.  If STARTKEYFUN is nil, the key
  12562. starts at the beginning of the record.
  12563.  
  12564. ENDKEYFUN moves from the start of the sort key to the end of the sort key.
  12565. ENDKEYFUN may be nil if STARTKEYFUN returns a value or if it would be the
  12566. same as ENDRECFUN.Fsort-lines
  12567. Sort lines in region alphabetically; argument means descending order.
  12568. Called from a program, there are three arguments:
  12569. REVERSE (non-nil means reverse order), BEG and END (region to sort).Fsort-paragraphs
  12570. Sort paragraphs in region alphabetically; argument means descending order.
  12571. Called from a program, there are three arguments:
  12572. REVERSE (non-nil means reverse order), BEG and END (region to sort).Fsort-pages
  12573. Sort pages in region alphabetically; argument means descending order.
  12574. Called from a program, there are three arguments:
  12575. REVERSE (non-nil means reverse order), BEG and END (region to sort).Fsort-numeric-fields
  12576. Sort lines in region numerically by the ARGth field of each line.
  12577. Fields are separated by whitespace and numbered from 1 up.
  12578. Specified field must contain a number in each line of the region.
  12579. With a negative arg, sorts by the ARGth field counted from the right.
  12580. Called from a program, there are three arguments:
  12581. FIELD, BEG and END.  BEG and END specify region to sort.Fsort-fields
  12582. Sort lines in region lexicographically by the ARGth field of each line.
  12583. Fields are separated by whitespace and numbered from 1 up.
  12584. With a negative arg, sorts by the ARGth field counted from the right.
  12585. Called from a program, there are three arguments:
  12586. FIELD, BEG and END.  BEG and END specify region to sort.Fsort-regexp-fields
  12587. Sort the region lexicographically as specified by RECORD-REGEXP and KEY.
  12588. RECORD-REGEXP specifies the textual units which should be sorted.
  12589.   For example, to sort lines RECORD-REGEXP would be "^.*$"
  12590. KEY specifies the part of each record (ie each match for RECORD-REGEXP)
  12591.   is to be used for sorting.
  12592.   If it is "\\digit" then the digit'th "\\(...\\)" match field from
  12593.   RECORD-REGEXP is used.
  12594.   If it is "\\&" then the whole record is used.
  12595.   Otherwise, it is a regular-expression for which to search within the record.
  12596. If a match for KEY is not found within a record then that record is ignored.
  12597.  
  12598. With a negative prefix arg sorts in reverse order.
  12599.  
  12600. For example: to sort lines in the region by the first word on each line
  12601.  starting with the letter "f",
  12602.  RECORD-REGEXP would be "^.*$" and KEY would be "\\=\<f\\w*\\>"Fsort-columns
  12603. Sort lines in region alphabetically by a certain range of columns.
  12604. For the purpose of this command, the region includes
  12605. the entire line that point is in and the entire line the mark is in.
  12606. The column positions of point and mark bound the range of columns to sort on.
  12607. A prefix argument means sort into reverse order.
  12608.  
  12609. Note that `sort-columns' rejects text that contains tabs,
  12610. because tabs could be split across the specified columns
  12611. and it doesn't know how to handle that.  Also, when possible,
  12612. it uses the `sort' utility program, which doesn't understand tabs.
  12613. Use \[untabify] to convert tabs to spaces before sorting.Freverse-region
  12614. Reverse the order of lines in a region.
  12615. From a program takes two point or marker arguments, BEG and END.Fspell-buffer
  12616. Check spelling of every word in the buffer.
  12617. For each incorrect word, you are asked for the correct spelling
  12618. and then put into a query-replace to fix some or all occurrences.
  12619. If you do not want to change a word, just give the same word
  12620. as its "correct" spelling; then the query replace is skipped.Fspell-word
  12621. Check spelling of word at or before point.
  12622. If it is not correct, ask user for the correct spelling
  12623. and `query-replace' the entire buffer to substitute it.Fspell-region
  12624. Like `spell-buffer' but applies only to region.
  12625. Used in a program, applies from START to END.
  12626. DESCRIPTION is an optional string naming the unit being checked:
  12627. for example, "word".Fspell-string
  12628. Check spelling of string supplied as argument.Fspook
  12629. Adds that special touch of class to your outgoing mail.Fsnarf-spooks
  12630. Return a vector containing the lines from `spook-phrases-file'.Fsc-cite-original
  12631. Workhorse citing function which performs the initial citation.
  12632. This is callable from the various mail and news readers' reply
  12633. function according to the agreed upon standard.  See `\[sc-describe]'
  12634. for more details.  `sc-cite-original' does not do any yanking of the
  12635. original message but it does require a few things:
  12636.  
  12637.      1) The reply buffer is the current buffer.
  12638.  
  12639.      2) The original message has been yanked and inserted into the
  12640.         reply buffer.
  12641.  
  12642.      3) Verbose mail headers from the original message have been
  12643.         inserted into the reply buffer directly before the text of the
  12644.         original message.
  12645.  
  12646.      4) Point is at the beginning of the verbose headers.
  12647.  
  12648.      5) Mark is at the end of the body of text to be cited.
  12649.  
  12650. For Emacs 19's, the region need not be active (and typically isn't
  12651. when this function is called.  Also, the hook `sc-pre-hook' is run
  12652. before, and `sc-post-hook' is run after the guts of this function.Funtabify
  12653. Convert all tabs in region to multiple spaces, preserving columns.
  12654. Called non-interactively, the region is specified by arguments
  12655. START and END, rather than by the position of point and mark.
  12656. The variable `tab-width' controls the spacing of tab stops.Ftabify
  12657. Convert multiple spaces in region to tabs when possible.
  12658. A group of spaces is partially replaced by tabs
  12659. when this can be done without changing the column they end at.
  12660. Called non-interactively, the region is specified by arguments
  12661. START and END, rather than by the position of point and mark.
  12662. The variable `tab-width' controls the spacing of tab stops.Ftalk-connect
  12663. Connect to display DISPLAY for the Emacs talk group.Ftar-mode
  12664. Major mode for viewing a tar file as a dired-like listing of its contents.
  12665. You can move around using the usual cursor motion commands. 
  12666. Letters no longer insert themselves.
  12667. Type `e' to pull a file out of the tar file and into its own buffer;
  12668. or click mouse-2 on the file's line in the Tar mode buffer.
  12669. Type `c' to copy an entry from the tar file into another file on disk.
  12670.  
  12671. If you edit a sub-file of this archive (as with the `e' command) and 
  12672. save it with Control-x Control-s, the contents of that buffer will be 
  12673. saved back into the tar-file buffer; in this way you can edit a file 
  12674. inside of a tar archive without extracting it and re-archiving it.
  12675.  
  12676. See also: variables `tar-update-datestamp' and `tar-anal-blocksize'.
  12677. \{tar-mode-map}Ftcl-mode
  12678. Major mode for editing tcl scripts.
  12679. The following keys are bound:
  12680. \{tcl-mode-map}
  12681. Ftelnet
  12682. Open a network login connection to host named HOST (a string).
  12683. Communication with HOST is recorded in a buffer `*telnet-HOST*'.
  12684. Normally input is edited in Emacs and sent a line at a time.Frsh
  12685. Open a network login connection to host named HOST (a string).
  12686. Communication with HOST is recorded in a buffer `*rsh-HOST*'.
  12687. Normally input is edited in Emacs and sent a line at a time.Fmake-term
  12688. Make a term process NAME in a buffer, running PROGRAM.
  12689. The name of the buffer is made by surrounding NAME with `*'s.
  12690. If there is already a running process in that buffer, it is not restarted.
  12691. Optional third arg STARTFILE is the name of a file to send the contents of to 
  12692. the process.  Any more args are arguments to PROGRAM.Fterm
  12693. Start a terminal-emulator in a new buffer.Fterminal-emulator
  12694. Under a display-terminal emulator in BUFFER, run PROGRAM on arguments ARGS.
  12695. ARGS is a list of argument-strings.  Remaining arguments are WIDTH and HEIGHT.
  12696. BUFFER's contents are made an image of the display generated by that program,
  12697. and any input typed when BUFFER is the current Emacs buffer is sent to that
  12698. program an keyboard input.
  12699.  
  12700. Interactively, BUFFER defaults to "*terminal*" and PROGRAM and ARGS
  12701. are parsed from an input-string using your usual shell.
  12702. WIDTH and HEIGHT are determined from the size of the current window
  12703. -- WIDTH will be one less than the window's width, HEIGHT will be its height.
  12704.  
  12705. To switch buffers and leave the emulator, or to give commands
  12706. to the emulator itself (as opposed to the program running under it),
  12707. type Control-^.  The following character is an emulator command.
  12708. Type Control-^ twice to send it to the subprogram.
  12709. This escape character may be changed using the variable `terminal-escape-char'.
  12710.  
  12711. `Meta' characters may not currently be sent through the terminal emulator.
  12712.  
  12713. Here is a list of some of the variables which control the behaviour
  12714. of the emulator -- see their documentation for more information:
  12715. terminal-escape-char, terminal-scrolling, terminal-more-processing,
  12716. terminal-redisplay-interval.
  12717.  
  12718. This function calls the value of terminal-mode-hook if that exists
  12719. and is non-nil after the terminal buffer has been set up and the
  12720. subprocess started.Vtex-shell-file-name
  12721. *If non-nil, the shell file name to run in the subshell used to run TeX.Vtex-directory
  12722. *Directory in which temporary files are left.
  12723. You can make this `/tmp' if your TEXINPUTS has no relative directories in it
  12724. and you don't try to apply \[tex-region] or \[tex-buffer] when there are
  12725. `\input' commands with relative directories.Vtex-offer-save
  12726. *If non-nil, ask about saving modified buffers before \[tex-file] is run.Vtex-run-command
  12727. *Command used to run TeX subjob.
  12728. If this string contains an asterisk (`*'), that is replaced by the file name;
  12729. otherwise, the file name, preceded by blank, is added at the end.Vlatex-run-command
  12730. *Command used to run LaTeX subjob.
  12731. If this string contains an asterisk (`*'), that is replaced by the file name;
  12732. otherwise, the file name, preceded by blank, is added at the end.Vlatex-block-names
  12733. *User defined LaTeX block names.
  12734. Combined with `standard-latex-block-names' for minibuffer completion.Vslitex-run-command
  12735. *Command used to run SliTeX subjob.
  12736. If this string contains an asterisk (`*'), that is replaced by the file name;
  12737. otherwise, the file name, preceded by blank, is added at the end.Vtex-bibtex-command
  12738. *Command used by `tex-bibtex-file' to gather bibliographic data.
  12739. If this string contains an asterisk (`*'), that is replaced by the file name;
  12740. otherwise, the file name, preceded by blank, is added at the end.Vtex-dvi-print-command
  12741. *Command used by \[tex-print] to print a .dvi file.
  12742. If this string contains an asterisk (`*'), that is replaced by the file name;
  12743. otherwise, the file name, preceded by blank, is added at the end.Vtex-alt-dvi-print-command
  12744. *Command used by \[tex-print] with a prefix arg to print a .dvi file.
  12745. If this string contains an asterisk (`*'), that is replaced by the file name;
  12746. otherwise, the file name, preceded by blank, is added at the end.
  12747.  
  12748. If two printers are not enough of a choice, you can set the variable
  12749. `tex-alt-dvi-print-command' to an expression that asks what you want;
  12750. for example,
  12751.  
  12752.     (setq tex-alt-dvi-print-command
  12753.          '(format "lpr -P%s" (read-string "Use printer: ")))
  12754.  
  12755. would tell \[tex-print] with a prefix argument to ask you which printer to
  12756. use.Vtex-dvi-view-command
  12757. *Command used by \[tex-view] to display a `.dvi' file.
  12758. If this string contains an asterisk (`*'), that is replaced by the file name;
  12759. otherwise, the file name, preceded by blank, is added at the end.
  12760.  
  12761. This can be set conditionally so that the previewer used is suitable for the
  12762. window system being used.  For example,
  12763.  
  12764.     (setq tex-dvi-view-command
  12765.           (if (eq window-system 'x) "xdvi" "dvi2tty * | cat -s"))
  12766.  
  12767. would tell \[tex-view] to use xdvi under X windows and to use dvi2tty
  12768. otherwise.Vtex-show-queue-command
  12769. *Command used by \[tex-show-print-queue] to show the print queue.
  12770. Should show the queue(s) that \[tex-print] puts jobs on.Vtex-default-mode
  12771. *Mode to enter for a new file that might be either TeX or LaTeX.
  12772. This variable is used when it can't be determined whether the file
  12773. is plain TeX or LaTeX or what because the file contains no commands.
  12774. Normally set to either `plain-tex-mode' or `latex-mode'.Vtex-open-quote
  12775. *String inserted by typing \[tex-insert-quote] to open a quotation.Vtex-close-quote
  12776. *String inserted by typing \[tex-insert-quote] to close a quotation.Ftex-mode
  12777. Major mode for editing files of input for TeX, LaTeX, or SliTeX.
  12778. Tries to determine (by looking at the beginning of the file) whether
  12779. this file is for plain TeX, LaTeX, or SliTeX and calls `plain-tex-mode',
  12780. `latex-mode', or `slitex-mode', respectively.  If it cannot be determined,
  12781. such as if there are no commands in the file, the value of `tex-default-mode'
  12782. says which mode to use.Fplain-tex-mode
  12783. Major mode for editing files of input for plain TeX.
  12784. Makes $ and } display the characters they match.
  12785. Makes " insert `` when it seems to be the beginning of a quotation,
  12786. and '' when it appears to be the end; it inserts " only after a \.
  12787.  
  12788. Use \[tex-region] to run TeX on the current region, plus a "header"
  12789. copied from the top of the file (containing macro definitions, etc.),
  12790. running TeX under a special subshell.  \[tex-buffer] does the whole buffer.
  12791. \[tex-file] saves the buffer and then processes the file.
  12792. \[tex-print] prints the .dvi file made by any of these.
  12793. \[tex-view] previews the .dvi file made by any of these.
  12794. \[tex-bibtex-file] runs bibtex on the file of the current buffer.
  12795.  
  12796. Use \[validate-tex-buffer] to check buffer for paragraphs containing
  12797. mismatched $'s or braces.
  12798.  
  12799. Special commands:
  12800. \{tex-mode-map}
  12801.  
  12802. Mode variables:
  12803. tex-run-command
  12804.     Command string used by \[tex-region] or \[tex-buffer].
  12805. tex-directory
  12806.     Directory in which to create temporary files for TeX jobs
  12807.     run by \[tex-region] or \[tex-buffer].
  12808. tex-dvi-print-command
  12809.     Command string used by \[tex-print] to print a .dvi file.
  12810. tex-alt-dvi-print-command
  12811.     Alternative command string used by \[tex-print] (when given a prefix
  12812.     argument) to print a .dvi file.
  12813. tex-dvi-view-command
  12814.     Command string used by \[tex-view] to preview a .dvi file.
  12815. tex-show-queue-command
  12816.     Command string used by \[tex-show-print-queue] to show the print
  12817.     queue that \[tex-print] put your job on.
  12818.  
  12819. Entering Plain-tex mode runs the hook `text-mode-hook', then the hook
  12820. `tex-mode-hook', and finally the hook `plain-tex-mode-hook'.  When the
  12821. special subshell is initiated, the hook `tex-shell-hook' is run.Flatex-mode
  12822. Major mode for editing files of input for LaTeX.
  12823. Makes $ and } display the characters they match.
  12824. Makes " insert `` when it seems to be the beginning of a quotation,
  12825. and '' when it appears to be the end; it inserts " only after a \.
  12826.  
  12827. Use \[tex-region] to run LaTeX on the current region, plus the preamble
  12828. copied from the top of the file (containing \documentstyle, etc.),
  12829. running LaTeX under a special subshell.  \[tex-buffer] does the whole buffer.
  12830. \[tex-file] saves the buffer and then processes the file.
  12831. \[tex-print] prints the .dvi file made by any of these.
  12832. \[tex-view] previews the .dvi file made by any of these.
  12833. \[tex-bibtex-file] runs bibtex on the file of the current buffer.
  12834.  
  12835. Use \[validate-tex-buffer] to check buffer for paragraphs containing
  12836. mismatched $'s or braces.
  12837.  
  12838. Special commands:
  12839. \{tex-mode-map}
  12840.  
  12841. Mode variables:
  12842. latex-run-command
  12843.     Command string used by \[tex-region] or \[tex-buffer].
  12844. tex-directory
  12845.     Directory in which to create temporary files for LaTeX jobs
  12846.     run by \[tex-region] or \[tex-buffer].
  12847. tex-dvi-print-command
  12848.     Command string used by \[tex-print] to print a .dvi file.
  12849. tex-alt-dvi-print-command
  12850.     Alternative command string used by \[tex-print] (when given a prefix
  12851.     argument) to print a .dvi file.
  12852. tex-dvi-view-command
  12853.     Command string used by \[tex-view] to preview a .dvi file.
  12854. tex-show-queue-command
  12855.     Command string used by \[tex-show-print-queue] to show the print
  12856.     queue that \[tex-print] put your job on.
  12857.  
  12858. Entering Latex mode runs the hook `text-mode-hook', then 
  12859. `tex-mode-hook', and finally `latex-mode-hook'.  When the special
  12860. subshell is initiated, `tex-shell-hook' is run.Fslitex-mode
  12861. Major mode for editing files of input for SliTeX.
  12862. Makes $ and } display the characters they match.
  12863. Makes " insert `` when it seems to be the beginning of a quotation,
  12864. and '' when it appears to be the end; it inserts " only after a \.
  12865.  
  12866. Use \[tex-region] to run SliTeX on the current region, plus the preamble
  12867. copied from the top of the file (containing \documentstyle, etc.),
  12868. running SliTeX under a special subshell.  \[tex-buffer] does the whole buffer.
  12869. \[tex-file] saves the buffer and then processes the file.
  12870. \[tex-print] prints the .dvi file made by any of these.
  12871. \[tex-view] previews the .dvi file made by any of these.
  12872. \[tex-bibtex-file] runs bibtex on the file of the current buffer.
  12873.  
  12874. Use \[validate-tex-buffer] to check buffer for paragraphs containing
  12875. mismatched $'s or braces.
  12876.  
  12877. Special commands:
  12878. \{tex-mode-map}
  12879.  
  12880. Mode variables:
  12881. slitex-run-command
  12882.     Command string used by \[tex-region] or \[tex-buffer].
  12883. tex-directory
  12884.     Directory in which to create temporary files for SliTeX jobs
  12885.     run by \[tex-region] or \[tex-buffer].
  12886. tex-dvi-print-command
  12887.     Command string used by \[tex-print] to print a .dvi file.
  12888. tex-alt-dvi-print-command
  12889.     Alternative command string used by \[tex-print] (when given a prefix
  12890.     argument) to print a .dvi file.
  12891. tex-dvi-view-command
  12892.     Command string used by \[tex-view] to preview a .dvi file.
  12893. tex-show-queue-command
  12894.     Command string used by \[tex-show-print-queue] to show the print
  12895.     queue that \[tex-print] put your job on.
  12896.  
  12897. Entering SliTeX mode runs the hook `text-mode-hook', then the hook
  12898. `tex-mode-hook', then the hook `latex-mode-hook', and finally the hook
  12899. `slitex-mode-hook'.  When the special subshell is initiated, the hook
  12900. `tex-shell-hook' is run.Ftexinfo-format-buffer
  12901. Process the current buffer as texinfo code, into an Info file.
  12902. The Info file output is generated in a buffer visiting the Info file
  12903. names specified in the @setfilename command.
  12904.  
  12905. Non-nil argument (prefix, if interactive) means don't make tag table
  12906. and don't split the file if large.  You can use Info-tagify and
  12907. Info-split to do these manually.Ftexinfo-format-region
  12908. Convert the current region of the Texinfo file to Info format.
  12909. This lets you see what that part of the file will look like in Info.
  12910. The command is bound to \[texinfo-format-region].  The text that is
  12911. converted to Info is stored in a temporary buffer.Ftexinfo-mode
  12912. Major mode for editing Texinfo files.
  12913.  
  12914.   It has these extra commands:
  12915. \{texinfo-mode-map}
  12916.  
  12917.   These are files that are used as input for TeX to make printed manuals
  12918. and also to be turned into Info files with \[makeinfo-buffer] or
  12919. the `makeinfo' program.  These files must be written in a very restricted and
  12920. modified version of TeX input format.
  12921.  
  12922.   Editing commands are like text-mode except that the syntax table is
  12923. set up so expression commands skip Texinfo bracket groups.  To see
  12924. what the Info version of a region of the Texinfo file will look like,
  12925. use \[makeinfo-region], which runs `makeinfo' on the current region.
  12926.  
  12927.   You can show the structure of a Texinfo file with \[texinfo-show-structure].
  12928. This command shows the structure of a Texinfo file by listing the
  12929. lines with the @-sign commands for @chapter, @section, and the like.
  12930. These lines are displayed in another window called the *Occur* window.
  12931. In that window, you can position the cursor over one of the lines and
  12932. use \[occur-mode-goto-occurrence], to jump to the corresponding spot
  12933. in the Texinfo file.
  12934.  
  12935.   In addition, Texinfo mode provides commands that insert various
  12936. frequently used @-sign commands into the buffer.  You can use these
  12937. commands to save keystrokes.  And you can insert balanced braces with
  12938. \[texinfo-insert-braces] and later use the command \[up-list] to
  12939. move forward past the closing brace.
  12940.  
  12941. Also, Texinfo mode provides functions for automatically creating or
  12942. updating menus and node pointers.  These functions
  12943.  
  12944.   * insert the `Next', `Previous' and `Up' pointers of a node,
  12945.   * insert or update the menu for a section, and
  12946.   * create a master menu for a Texinfo source file.
  12947.  
  12948. Here are the functions:
  12949.  
  12950.     texinfo-update-node                \[texinfo-update-node]
  12951.     texinfo-every-node-update          \[texinfo-every-node-update]
  12952.     texinfo-sequential-node-update 
  12953.  
  12954.     texinfo-make-menu                  \[texinfo-make-menu]
  12955.     texinfo-all-menus-update           \[texinfo-all-menus-update]
  12956.     texinfo-master-menu
  12957.  
  12958.     texinfo-indent-menu-description (column &optional region-p)
  12959.  
  12960. The `texinfo-column-for-description' variable specifies the column to
  12961. which menu descriptions are indented. 
  12962.  
  12963. Passed an argument (a prefix argument, if interactive), the
  12964. `texinfo-update-node' and `texinfo-make-menu' functions do their jobs
  12965. in the region.
  12966.  
  12967. To use the updating commands, you must structure your Texinfo file
  12968. hierarchically, such that each `@node' line, with the exception of the
  12969. Top node, is accompanied by some kind of section line, such as an
  12970. `@chapter' or `@section' line.
  12971.  
  12972. If the file has a `top' node, it must be called `top' or `Top' and
  12973. be the first node in the file.
  12974.  
  12975. Entering Texinfo mode calls the value of text-mode-hook, and then the
  12976. value of texinfo-mode-hook.Ftexinfo-update-node
  12977. Without any prefix argument, update the node in which point is located.
  12978. Non-nil argument (prefix, if interactive) means update the nodes in the
  12979. marked region.
  12980.  
  12981. The functions for creating or updating nodes and menus, and their
  12982. keybindings, are:
  12983.  
  12984.     texinfo-update-node (&optional region-p)    \[texinfo-update-node]
  12985.     texinfo-every-node-update ()                \[texinfo-every-node-update]
  12986.     texinfo-sequential-node-update (&optional region-p)
  12987.  
  12988.     texinfo-make-menu (&optional region-p)      \[texinfo-make-menu]
  12989.     texinfo-all-menus-update ()                 \[texinfo-all-menus-update]
  12990.     texinfo-master-menu ()
  12991.  
  12992.     texinfo-indent-menu-description (column &optional region-p)
  12993.  
  12994. The `texinfo-column-for-description' variable specifies the column to
  12995. which menu descriptions are indented. Its default value is 32.Ftexinfo-every-node-update
  12996. Update every node in a Texinfo file.Ftexinfo-sequential-node-update
  12997. Update one node (or many) in a Texinfo file with sequential pointers.
  12998.  
  12999. This function causes the `Next' or `Previous' pointer to point to the
  13000. immediately preceding or following node, even if it is at a higher or
  13001. lower hierarchical level in the document.  Continually pressing `n' or
  13002. `p' takes you straight through the file.
  13003.  
  13004. Without any prefix argument, update the node in which point is located.
  13005. Non-nil argument (prefix, if interactive) means update the nodes in the
  13006. marked region.
  13007.  
  13008. This command makes it awkward to navigate among sections and
  13009. subsections; it should be used only for those documents that are meant
  13010. to be read like a novel rather than a reference, and for which the
  13011. Info `g*' command is inadequate.Fforward-thing
  13012. Move forward to the end of the next THING.Fbounds-of-thing-at-point
  13013. Determine the start and end buffer locations for the THING at point,
  13014. where THING is an entity for which there is a either a corresponding
  13015. forward-THING operation, or corresponding beginning-of-THING and
  13016. end-of-THING operations, eg. 'word, 'sentence, 'defun.
  13017.   Return a cons cell '(start . end) giving the start and end positions.Fthing-at-point
  13018. Return the THING at point, where THING is an entity defined by
  13019. bounds-of-thing-at-point.Vdisplay-time-day-and-date
  13020. *Non-nil means \[display-time] should display day and date as well as time.Fdisplay-time
  13021. Display current time, load level, and mail flag in mode line of each buffer.
  13022. Updates automatically every minute.
  13023. If `display-time-day-and-date' is non-nil, the current day and date
  13024. are displayed as well.
  13025. After each update, `display-time-hook' is run with `run-hooks'.Ftime-stamp
  13026. Update the time stamp string in the buffer.
  13027. If you put a time stamp template anywhere in the first 8 lines of a file,
  13028. it can be updated every time you save the file.  See the top of
  13029. `time-stamp.el' for a sample.  The template looks like one of the following:
  13030.     Time-stamp: <>
  13031.     Time-stamp: " "
  13032. The time stamp is written between the brackets or quotes, resulting in
  13033.     Time-stamp: <95/01/18 10:20:51 gildea>
  13034. Only does its thing if the variable  time-stamp-active  is non-nil.
  13035. Typically used on  write-file-hooks  for automatic time-stamping.
  13036. The format of the time stamp is determined by the variable  time-stamp-format.
  13037. The variables time-stamp-line-limit, time-stamp-start, and time-stamp-end
  13038. control finding the template.Ftime-stamp-toggle-active
  13039. Toggle time-stamp-active, setting whether \[time-stamp] updates a buffer.
  13040. With arg, turn time stamping on if and only if arg is positive.Frun-at-time
  13041. Perform an action after a delay of SECS seconds.
  13042. Repeat the action every REPEAT seconds, if REPEAT is non-nil.
  13043. TIME should be a string like "11:23pm", nil meaning now, a number of seconds
  13044. from now, or a value from `encode-time'.
  13045. REPEAT may be an integer or floating point number.
  13046. The action is to call FUNCTION with arguments ARGS.
  13047.  
  13048. This function returns a timer object which you can use in `cancel-timer'.Frun-with-timer
  13049. Perform an action after a delay of SECS seconds.
  13050. Repeat the action every REPEAT seconds, if REPEAT is non-nil.
  13051. SECS and REPEAT may be integers or floating point numbers.
  13052. The action is to call FUNCTION with arguments ARGS.
  13053.  
  13054. This function returns a timer object which you can use in `cancel-timer'.Fadd-timeout
  13055. Add a timer to run SECS seconds from now, to call FUNCTION on OBJECT.
  13056. If REPEAT is non-nil, repeat the timer every REPEAT seconds.
  13057. This function is for compatibility; see also `run-with-timer'.Frun-with-idle-timer
  13058. Perform an action the next time Emacs is idle for SECS seconds.
  13059. If REPEAT is non-nil, do this each time Emacs is idle for SECS seconds.
  13060. SECS may be an integer or a floating point number.
  13061. The action is to call FUNCTION with arguments ARGS.
  13062.  
  13063. This function returns a timer object which you can use in `cancel-timer'.Fwith-timeout
  13064. Run BODY, but if it doesn't finish in SECONDS seconds, give up.
  13065. If we give up, we run the TIMEOUT-FORMS and return the value of the last one.
  13066. The call should look like:
  13067.  (with-timeout (SECONDS TIMEOUT-FORMS...) BODY...)
  13068. The timeout is checked whenever Emacs waits for some kind of external
  13069. event (such as keyboard input, input from subprocesses, or a certain time);
  13070. if the program loops without waiting in any way, the timeout will not
  13071. be detected.Ftmm-menubar
  13072. Text-mode emulation of looking and choosing from a menubar.
  13073. See the documentation for `tmm-prompt'.
  13074. X-POSITION, if non-nil, specifies a horizontal position within the menu bar;
  13075. we make that menu bar item (the one at that position) the default choice.Ftmm-menubar-mouse
  13076. Text-mode emulation of looking and choosing from a menubar.
  13077. This command is used when you click the mouse in the menubar
  13078. on a console which has no window system but does have a mouse.
  13079. See the documentation for `tmm-prompt'.Ftmm-prompt
  13080. Text-mode emulation of calling the bindings in keymap.
  13081. Creates a text-mode menu of possible choices.  You can access the elements
  13082. in the menu in two ways:
  13083.    *)  via history mechanism from minibuffer;
  13084.    *)  Or via completion-buffer that is automatically shown.
  13085. The last alternative is currently a hack, you cannot use mouse reliably.
  13086.  
  13087. MENU is like the MENU argument to `x-popup-menu': either a
  13088. keymap or an alist of alists.
  13089. DEFAULT-ITEM, if non-nil, specifies an initial default choice.
  13090. Its value should be an event that has a binding in MENU.Ftpu-edt-on
  13091. Turn on TPU/edt emulation.Ftpu-set-scroll-margins
  13092. Set scroll margins.Ftpu-set-cursor-free
  13093. Allow the cursor to move freely about the screen.Ftpu-set-cursor-bound
  13094. Constrain the cursor to the flow of the text.Ftq-create
  13095. Create and return a transaction queue communicating with PROCESS.
  13096. PROCESS should be a subprocess capable of sending and receiving
  13097. streams of bytes.  It may be a local process, or it may be connected
  13098. to a tcp server on another machine.Vtrace-buffer
  13099. *Trace output will by default go to that buffer.Ftrace-function
  13100. Traces FUNCTION with trace output going to BUFFER.
  13101. For every call of FUNCTION Lisp-style trace messages that display argument
  13102. and return values will be inserted into BUFFER. This function generates the
  13103. trace advice for FUNCTION and activates it together with any other advice
  13104. there might be!! The trace BUFFER will popup whenever FUNCTION is called.
  13105. Do not use this to trace functions that switch buffers or do any other
  13106. display oriented stuff, use `trace-function-background' instead.Ftrace-function-background
  13107. Traces FUNCTION with trace output going quietly to BUFFER.
  13108. For every call of FUNCTION Lisp-style trace messages that display argument
  13109. and return values will be inserted into BUFFER. This function generates the
  13110. trace advice for FUNCTION and activates it together with any other advice
  13111. there might be!! Trace output will quietly go to BUFFER without changing
  13112. the window or buffer configuration at all.F2C-two-columns
  13113. Split current window vertically for two-column editing.
  13114. When called the first time, associates a buffer with the current
  13115. buffer in two-column minor mode (see  \[describe-mode] ).
  13116. Runs `2C-other-buffer-hook' in the new buffer.
  13117. When called again, restores the screen layout with the current buffer
  13118. first and the associated buffer to it's right.F2C-associate-buffer
  13119. Associate another buffer with this one in two-column minor mode.
  13120. Can also be used to associate a just previously visited file, by
  13121. accepting the proposed default buffer.
  13122.  
  13123. (See  \[describe-mode] .)F2C-split
  13124. Split a two-column text at point, into two buffers in two-column minor mode.
  13125. Point becomes the local value of `2C-window-width'.  Only lines that
  13126. have the ARG same preceding characters at that column get split.  The
  13127. ARG preceding characters without any leading whitespace become the local
  13128. value for `2C-separator'.  This way lines that continue across both
  13129. columns remain untouched in the first buffer.
  13130.  
  13131. This function can be used with a prototype line, to set up things.  You
  13132. write the first line of each column and then split that line.  E.g.:
  13133.  
  13134. First column's text    sSs  Second column's text
  13135.                \___/\
  13136.             /    \
  13137.    5 character Separator      You type  M-5 \[2C-split]  with the point here.
  13138.  
  13139. (See  \[describe-mode] .)Vtype-break-mode
  13140. *Non-`nil' means typing break mode is enabled.
  13141. See the docstring for the `type-break-mode' command for more information.Vtype-break-interval
  13142. *Number of seconds between scheduled typing breaks.Vtype-break-good-rest-interval
  13143. *Number of seconds of idle time considered to be an adequate typing rest.
  13144.  
  13145. When this variable is non-`nil', emacs checks the idle time between
  13146. keystrokes.  If this idle time is long enough to be considered a "good"
  13147. rest from typing, then the next typing break is simply rescheduled for later.
  13148.  
  13149. If a break is interrupted before this much time elapses, the user will be
  13150. asked whether or not really to interrupt the break.Vtype-break-keystroke-threshold
  13151. *Upper and lower bound on number of keystrokes for considering typing break.
  13152. This structure is a pair of numbers.
  13153.  
  13154. The first number is the minimum number of keystrokes that must have been
  13155. entered since the last typing break before considering another one, even if
  13156. the scheduled time has elapsed; the break is simply rescheduled until later
  13157. if the minimum threshold hasn't been reached.  If this first value is nil,
  13158. then there is no minimum threshold; as soon as the scheduled time has
  13159. elapsed, the user will always be queried.
  13160.  
  13161. The second number is the maximum number of keystrokes that can be entered
  13162. before a typing break is requested immediately, pre-empting the originally
  13163. scheduled break.  If this second value is nil, then no pre-emptive breaks
  13164. will occur; only scheduled ones will.
  13165.  
  13166. Keys with bucky bits (shift, control, meta, etc) are counted as only one
  13167. keystroke even though they really require multiple keys to generate them.
  13168.  
  13169. The command `type-break-guesstimate-keystroke-threshold' can be used to
  13170. guess a reasonably good pair of values for this variable.Ftype-break-mode
  13171. Enable or disable typing-break mode.
  13172. This is a minor mode, but it is global to all buffers by default.
  13173.  
  13174. When this mode is enabled, the user is encouraged to take typing breaks at
  13175. appropriate intervals; either after a specified amount of time or when the
  13176. user has exceeded a keystroke threshold.  When the time arrives, the user
  13177. is asked to take a break.  If the user refuses at that time, emacs will ask
  13178. again in a short period of time.  The idea is to give the user enough time
  13179. to find a good breaking point in his or her work, but be sufficiently
  13180. annoying to discourage putting typing breaks off indefinitely.
  13181.  
  13182. A negative prefix argument disables this mode.
  13183. No argument or any non-negative argument enables it.
  13184.  
  13185. The user may enable or disable this mode by setting the variable of the
  13186. same name, though setting it in that way doesn't reschedule a break or
  13187. reset the keystroke counter.
  13188.  
  13189. If the mode was previously disabled and is enabled as a consequence of
  13190. calling this function, it schedules a break with `type-break-schedule' to
  13191. make sure one occurs (the user can call that command to reschedule the
  13192. break at any time).  It also initializes the keystroke counter.
  13193.  
  13194. The variable `type-break-interval' specifies the number of seconds to
  13195. schedule between regular typing breaks.  This variable doesn't directly
  13196. affect the time schedule; it simply provides a default for the
  13197. `type-break-schedule' command.
  13198.  
  13199. If set, the variable `type-break-good-rest-interval' specifies the minimum
  13200. amount of time which is considered a reasonable typing break.  Whenever
  13201. that time has elapsed, typing breaks are automatically rescheduled for
  13202. later even if emacs didn't prompt you to take one first.  Also, if a break
  13203. is ended before this much time has elapsed, the user will be asked whether
  13204. or not to continue.
  13205.  
  13206. The variable `type-break-keystroke-threshold' is used to determine the
  13207. thresholds at which typing breaks should be considered.  You can use
  13208. the command `type-break-guesstimate-keystroke-threshold' to try to
  13209. approximate good values for this.
  13210.  
  13211. There are several variables that affect how or when warning messages about
  13212. imminent typing breaks are displayed.  They include:
  13213.  
  13214.         type-break-warning-message-mode
  13215.         type-break-time-warning-intervals
  13216.         type-break-keystroke-warning-intervals
  13217.         type-break-warning-repeat
  13218.         type-break-warning-countdown-string
  13219.         type-break-warning-countdown-string-type
  13220.  
  13221. There are several variables that affect how and when queries to begin a
  13222. typing break occur.  They include:
  13223.  
  13224.         type-break-query-function
  13225.         type-break-query-interval
  13226.  
  13227. Finally, the command `type-break-statistics' prints interesting things.Ftype-break
  13228. Take a typing break.
  13229.  
  13230. During the break, a demo selected from the functions listed in
  13231. `type-break-demo-functions' is run.
  13232.  
  13233. After the typing break is finished, the next break is scheduled
  13234. as per the function `type-break-schedule'.Ftype-break-statistics
  13235. Print statistics about typing breaks in a temporary buffer.
  13236. This includes the last time a typing break was taken, when the next one is
  13237. scheduled, the keystroke thresholds and the current keystroke count, etc.Ftype-break-guesstimate-keystroke-threshold
  13238. Guess values for the minimum/maximum keystroke threshold for typing breaks.
  13239.  
  13240. If called interactively, the user is prompted for their guess as to how
  13241. many words per minute they usually type.  This value should not be your
  13242. maximum WPM, but your average.  Of course, this is harder to gauge since it
  13243. can vary considerably depending on what you are doing.  For example, one
  13244. tends actually to type less when debugging a program, as opposed to writing
  13245. documentation.  (Perhaps a separate program should be written to estimate
  13246. average typing speed.)
  13247.  
  13248. From that, this command sets the values in `type-break-keystroke-threshold'
  13249. based on a fairly simple algorithm involving assumptions about the average
  13250. length of words (5).  For the minimum threshold, it uses about a fifth of
  13251. the computed maximum threshold.
  13252.  
  13253. When called from lisp programs, the optional args WORDLEN and FRAC can be
  13254. used to override the default assumption about average word length and the
  13255. fraction of the maximum threshold to which to set the minimum threshold.
  13256. FRAC should be the inverse of the fractional value; for example, a value of
  13257. 2 would mean to use one half, a value of 4 would mean to use one quarter, etc.Funderline-region
  13258. Underline all nonblank characters in the region.
  13259. Works by overstriking underscores.
  13260. Called from program, takes two arguments START and END
  13261. which specify the range to operate on.Fununderline-region
  13262. Remove all underlining (overstruck underscores) in the region.
  13263. Called from program, takes two arguments START and END
  13264. which specify the range to operate on.Fbatch-unrmail
  13265. Convert Rmail files to system inbox format.
  13266. Specify the input Rmail file names as command line arguments.
  13267. For each Rmail file, the corresponding output file name
  13268. is made by adding `.mail' at the end.
  13269. For example, invoke `emacs -batch -f batch-unrmail RMAIL'.Funrmail
  13270. Convert Rmail file FILE to system inbox format file TO-FILE.Fask-user-about-lock
  13271. Ask user what to do when he wants to edit FILE but it is locked by USER.
  13272. This function has a choice of three things to do:
  13273.   do (signal 'buffer-file-locked (list FILE USER))
  13274.     to refrain from editing the file
  13275.   return t (grab the lock on the file)
  13276.   return nil (edit the file even though it is locked).
  13277. You can rewrite it to use any criterion you like to choose which one to do.Fask-user-about-supersession-threat
  13278. Ask a user who is about to modify an obsolete buffer what to do.
  13279. This function has two choices: it can return, in which case the modification
  13280. of the buffer will proceed, or it can (signal 'file-supersession (file)),
  13281. in which case the proposed buffer modification will not be made.
  13282.  
  13283. You can rewrite this to use any criterion you like to choose which one to do.
  13284. The buffer in question is current when this function is called.Vvc-checkin-hook
  13285. *List of functions called after a checkin is done.  See `run-hooks'.Fvc-next-action
  13286. Do the next logical checkin or checkout operation on the current file.
  13287.    If you call this from within a VC dired buffer with no files marked,
  13288. it will operate on the file in the current line.
  13289.    If you call this from within a VC dired buffer, and one or more
  13290. files are marked, it will accept a log message and then operate on
  13291. each one.  The log message will be used as a comment for any register
  13292. or checkin operations, but ignored when doing checkouts.  Attempted
  13293. lock steals will raise an error.
  13294.    A prefix argument lets you specify the version number to use.
  13295.  
  13296. For RCS and SCCS files:
  13297.    If the file is not already registered, this registers it for version
  13298. control and then retrieves a writable, locked copy for editing.
  13299.    If the file is registered and not locked by anyone, this checks out
  13300. a writable and locked file ready for editing.
  13301.    If the file is checked out and locked by the calling user, this
  13302. first checks to see if the file has changed since checkout.  If not,
  13303. it performs a revert.
  13304.    If the file has been changed, this pops up a buffer for entry
  13305. of a log message; when the message has been entered, it checks in the
  13306. resulting changes along with the log message as change commentary.  If
  13307. the variable `vc-keep-workfiles' is non-nil (which is its default), a
  13308. read-only copy of the changed file is left in place afterwards.
  13309.    If the file is registered and locked by someone else, you are given
  13310. the option to steal the lock.
  13311.  
  13312. For CVS files:
  13313.    If the file is not already registered, this registers it for version
  13314. control.  This does a "cvs add", but no "cvs commit".
  13315.    If the file is added but not committed, it is committed.
  13316.    If your working file is changed, but the repository file is
  13317. unchanged, this pops up a buffer for entry of a log message; when the
  13318. message has been entered, it checks in the resulting changes along
  13319. with the logmessage as change commentary.  A writable file is retained.
  13320.    If the repository file is changed, you are asked if you want to
  13321. merge in the changes into your working copy.Fvc-register
  13322. Register the current file into your version-control system.Fvc-diff
  13323. Display diffs between file versions.
  13324. Normally this compares the current file and buffer with the most recent 
  13325. checked in version of that file.  This uses no arguments.
  13326. With a prefix argument, it reads the file name to use
  13327. and two version designators specifying which versions to compare.Fvc-version-other-window
  13328. Visit version REV of the current buffer in another window.
  13329. If the current buffer is named `F', the version is named `F.~REV~'.
  13330. If `F.~REV~' already exists, it is used instead of being re-created.Fvc-insert-headers
  13331. Insert headers in a file for use with your version-control system.
  13332. Headers desired are inserted at the start of the buffer, and are pulled from
  13333. the variable `vc-header-alist'.Fvc-directory
  13334. Show version-control status of the current directory and subdirectories.
  13335. Normally it creates a Dired buffer that lists only the locked files
  13336. in all these directories.  With a prefix argument, it lists all files.Fvc-create-snapshot
  13337. Make a snapshot called NAME.
  13338. The snapshot is made from all registered files at or below the current
  13339. directory.  For each file, the version level of its latest
  13340. version becomes part of the named configuration.Fvc-retrieve-snapshot
  13341. Retrieve the snapshot called NAME.
  13342. This function fails if any files are locked at or below the current directory
  13343. Otherwise, all registered files are checked out (unlocked) at their version
  13344. levels in the snapshot.Fvc-print-log
  13345. List the change log of the current buffer in a window.Fvc-revert-buffer
  13346. Revert the current buffer's file back to the latest checked-in version.
  13347. This asks for confirmation if the buffer contents are not identical
  13348. to that version.
  13349. If the back-end is CVS, this will give you the most recent revision of
  13350. the file on the branch you are editing.Fvc-cancel-version
  13351. Get rid of most recently checked in version of this file.
  13352. A prefix argument means do not revert the buffer afterwards.Fvc-rename-file
  13353. Rename file OLD to NEW, and rename its master file likewise.Fvc-update-change-log
  13354. Find change log file and add entries from recent RCS logs.
  13355. The mark is left at the end of the text prepended to the change log.
  13356. With prefix arg of C-u, only find log entries for the current buffer's file.
  13357. With any numeric prefix arg, find log entries for all files currently visited.
  13358. Otherwise, find log entries for all registered files in the default directory.
  13359. From a program, any arguments are passed to the `rcs2log' script.Fvi-mode
  13360. Major mode that acts like the `vi' editor.
  13361. The purpose of this mode is to provide you the combined power of vi (namely,
  13362. the "cross product" effect of commands and repeat last changes) and Emacs.
  13363.  
  13364. This command redefines nearly all keys to look like vi commands.
  13365. It records the previous major mode, and any vi command for input
  13366. (`i', `a', `s', etc.) switches back to that mode.
  13367. Thus, ordinary Emacs (in whatever major mode you had been using)
  13368. is "input" mode as far as vi is concerned.
  13369.  
  13370. To get back into vi from "input" mode, you must issue this command again.
  13371. Therefore, it is recommended that you assign it to a key.
  13372.  
  13373. Major differences between this mode and real vi :
  13374.  
  13375. * Limitations and unsupported features
  13376.   - Search patterns with line offset (e.g. /pat/+3 or /pat/z.) are
  13377.     not supported.
  13378.   - Ex commands are not implemented; try ':' to get some hints.
  13379.   - No line undo (i.e. the 'U' command), but multi-undo is a standard feature.
  13380.  
  13381. * Modifications
  13382.   - The stopping positions for some point motion commands (word boundary,
  13383.     pattern search) are slightly different from standard 'vi'.
  13384.     Also, no automatic wrap around at end of buffer for pattern searching.
  13385.   - Since changes are done in two steps (deletion then insertion), you need
  13386.     to undo twice to completely undo a change command.  But this is not needed
  13387.     for undoing a repeated change command.
  13388.   - No need to set/unset 'magic', to search for a string with regular expr
  13389.     in it just put a prefix arg for the search commands.  Replace cmds too.
  13390.   - ^R is bound to incremental backward search, so use ^L to redraw screen.
  13391.  
  13392. * Extensions
  13393.   - Some standard (or modified) Emacs commands were integrated, such as
  13394.     incremental search, query replace, transpose objects, and keyboard macros.
  13395.   - In command state, ^X links to the 'ctl-x-map', and ESC can be linked to
  13396.     esc-map or set undefined.  These can give you the full power of Emacs.
  13397.   - See vi-com-map for those keys that are extensions to standard vi, e.g.
  13398.     `vi-name-last-change-or-macro', `vi-verify-spelling', `vi-locate-def',
  13399.     `vi-mark-region', and 'vi-quote-words'.  Some of them are quite handy.
  13400.   - Use \[vi-switch-mode] to switch among different modes quickly.
  13401.  
  13402. Syntax table and abbrevs while in vi mode remain as they were in Emacs.Vview-highlight-face
  13403. *The overlay face used for highlighting the match found by View mode search.Fview-file
  13404. View FILE in View mode, returning to previous buffer when done.
  13405. The usual Emacs commands are not available; instead,
  13406. a special set of commands (mostly letters and punctuation)
  13407. are defined for moving around in the buffer.
  13408. Space scrolls forward, Delete scrolls backward.
  13409. For list of all View commands, type ? or h while viewing.
  13410.  
  13411. This command runs the normal hook `view-mode-hook'.Fview-file-other-window
  13412. View FILE in View mode in other window.
  13413. Return to previous buffer when done.
  13414. The usual Emacs commands are not available; instead,
  13415. a special set of commands (mostly letters and punctuation)
  13416. are defined for moving around in the buffer.
  13417. Space scrolls forward, Delete scrolls backward.
  13418. For list of all View commands, type ? or h while viewing.
  13419.  
  13420. This command runs the normal hook `view-mode-hook'.Fview-buffer
  13421. View BUFFER in View mode, returning to previous buffer when done.
  13422. The usual Emacs commands are not available; instead,
  13423. a special set of commands (mostly letters and punctuation)
  13424. are defined for moving around in the buffer.
  13425. Space scrolls forward, Delete scrolls backward.
  13426. For list of all View commands, type ? or h while viewing.
  13427.  
  13428. This command runs the normal hook `view-mode-hook'.Fview-buffer-other-window
  13429. View BUFFER in View mode in another window.
  13430. Return to previous buffer when done, unless NOT-RETURN is non-nil.
  13431.  
  13432. The usual Emacs commands are not available in View mode; instead,
  13433. a special set of commands (mostly letters and punctuation)
  13434. are defined for moving around in the buffer.
  13435. Space scrolls forward, Delete scrolls backward.
  13436. For list of all View commands, type ? or h while viewing.
  13437.  
  13438. This command runs the normal hook `view-mode-hook'.Fview-mode
  13439. Toggle View mode.
  13440. With a prefix argument, turn View mode on if the argument is >= zero
  13441. and off if it is not.
  13442.  
  13443. If you use this function to turn on View mode, then subsequently
  13444. "exiting" View mode does nothing except turn View mode off.  The
  13445. other way to turn View mode on is by calling `view-mode-enter';
  13446. that is what Lisp programs usually use.
  13447.  
  13448. Letters do not insert themselves.  Instead these commands are provided.
  13449. Most commands take prefix arguments.  Commands dealing with lines
  13450. default to "scroll size" lines (initially size of window).
  13451. Search commands default to a repeat count of one.
  13452.  
  13453. M-< or <    move to beginning of buffer.
  13454. M-> or >    move to end of buffer.
  13455. C-v or Space    scroll forward lines.
  13456. M-v or DEL    scroll backward lines.
  13457. CR or LF    scroll forward one line (backward with prefix argument).
  13458. z        like Space except set number of lines for further
  13459.            scrolling commands to scroll by.
  13460. C-u and Digits    provide prefix arguments.  `-' denotes negative argument.
  13461. =        prints the current line number.
  13462. g        goes to line given by prefix argument.
  13463. / or M-C-s    searches forward for regular expression
  13464. \ or M-C-r    searches backward for regular expression.
  13465. n        searches forward for last regular expression.
  13466. p        searches backward for last regular expression.
  13467. C-@ or .    set the mark.
  13468. x        exchanges point and mark.
  13469. C-s or s    do forward incremental search.
  13470. C-r or r    do reverse incremental search.
  13471. @ or '        return to mark and pops mark ring.
  13472.           Mark ring is pushed at start of every
  13473.           successful search and when jump to line to occurs.
  13474.           The mark is set on jump to buffer start or end.
  13475. ? or h        provide help message (list of commands).
  13476. \[help-command]        provides help (list of commands or description of a command).
  13477. C-n        moves down lines vertically.
  13478. C-p        moves upward lines vertically.
  13479. C-l        recenters the screen.
  13480. q        exit view-mode and return to previous buffer.Fvip-mode
  13481. Turn on VIP emulation of VI.Fviper-mode
  13482. Turn on Viper emulation of Vi.Fwordstar-mode
  13483. Major mode with WordStar-like key bindings.
  13484.  
  13485. BUGS:
  13486.  - Help menus with WordStar commands (C-j just calls help-for-help)
  13487.    are not implemented
  13488.  - Options for search and replace
  13489.  - Show markers (C-k h) is somewhat strange
  13490.  - Search and replace (C-q a) is only available in forward direction
  13491.  
  13492. No key bindings beginning with ESC are installed, they will work
  13493. Emacs-like.
  13494.  
  13495. The key bindings are:
  13496.  
  13497.   C-a        backward-word
  13498.   C-b        fill-paragraph
  13499.   C-c        scroll-up-line
  13500.   C-d        forward-char
  13501.   C-e        previous-line
  13502.   C-f        forward-word
  13503.   C-g        delete-char
  13504.   C-h        backward-char
  13505.   C-i        indent-for-tab-command
  13506.   C-j        help-for-help
  13507.   C-k        ordstar-C-k-map
  13508.   C-l        ws-repeat-search
  13509.   C-n        open-line
  13510.   C-p        quoted-insert
  13511.   C-r        scroll-down-line
  13512.   C-s        backward-char
  13513.   C-t        kill-word
  13514.   C-u        keyboard-quit
  13515.   C-v        overwrite-mode
  13516.   C-w        scroll-down
  13517.   C-x        next-line
  13518.   C-y        kill-complete-line
  13519.   C-z        scroll-up
  13520.  
  13521.   C-k 0        ws-set-marker-0
  13522.   C-k 1        ws-set-marker-1
  13523.   C-k 2        ws-set-marker-2
  13524.   C-k 3        ws-set-marker-3
  13525.   C-k 4        ws-set-marker-4
  13526.   C-k 5        ws-set-marker-5
  13527.   C-k 6        ws-set-marker-6
  13528.   C-k 7        ws-set-marker-7
  13529.   C-k 8        ws-set-marker-8
  13530.   C-k 9        ws-set-marker-9
  13531.   C-k b        ws-begin-block
  13532.   C-k c        ws-copy-block
  13533.   C-k d        save-buffers-kill-emacs
  13534.   C-k f        find-file
  13535.   C-k h        ws-show-markers
  13536.   C-k i        ws-indent-block
  13537.   C-k k        ws-end-block
  13538.   C-k p        ws-print-block
  13539.   C-k q        kill-emacs
  13540.   C-k r        insert-file
  13541.   C-k s        save-some-buffers
  13542.   C-k t        ws-mark-word
  13543.   C-k u        ws-exdent-block
  13544.   C-k C-u    keyboard-quit
  13545.   C-k v        ws-move-block
  13546.   C-k w        ws-write-block
  13547.   C-k x        kill-emacs
  13548.   C-k y        ws-delete-block
  13549.  
  13550.   C-o c        wordstar-center-line
  13551.   C-o b        switch-to-buffer
  13552.   C-o j        justify-current-line
  13553.   C-o k        kill-buffer
  13554.   C-o l        list-buffers
  13555.   C-o m        auto-fill-mode
  13556.   C-o r        set-fill-column
  13557.   C-o C-u    keyboard-quit
  13558.   C-o wd    delete-other-windows
  13559.   C-o wh    split-window-horizontally
  13560.   C-o wo    other-window
  13561.   C-o wv    split-window-vertically
  13562.  
  13563.   C-q 0        ws-find-marker-0
  13564.   C-q 1        ws-find-marker-1
  13565.   C-q 2        ws-find-marker-2
  13566.   C-q 3        ws-find-marker-3
  13567.   C-q 4        ws-find-marker-4
  13568.   C-q 5        ws-find-marker-5
  13569.   C-q 6        ws-find-marker-6
  13570.   C-q 7        ws-find-marker-7
  13571.   C-q 8        ws-find-marker-8
  13572.   C-q 9        ws-find-marker-9
  13573.   C-q a        ws-query-replace
  13574.   C-q b        ws-to-block-begin
  13575.   C-q c        end-of-buffer
  13576.   C-q d        end-of-line
  13577.   C-q f        ws-search
  13578.   C-q k        ws-to-block-end
  13579.   C-q l        ws-undo
  13580.   C-q p        ws-last-cursorp
  13581.   C-q r        beginning-of-buffer
  13582.   C-q C-u    keyboard-quit
  13583.   C-q w        ws-last-error
  13584.   C-q y        ws-kill-eol
  13585.   C-q DEL    ws-kill-bol
  13586. Fxterm-mouse-mode
  13587. Toggle XTerm mouse mode.
  13588. With prefix arg, turn XTerm mouse mode on iff arg is positive.
  13589.  
  13590. Turn it on to use emacs mouse commands, and off to use xterm mouse commands.Fyow
  13591. Return or display a random Zippy quotation.  With prefix arg, insert it.Finsert-zippyism
  13592. Prompt with completion for a known Zippy quotation, and insert it at point.Fapropos-zippy
  13593. Return a list of all Zippy quotes matching REGEXP.
  13594. If called interactively, display a list of matches.Fpsychoanalyze-pinhead
  13595. Zippy goes to the analyst.Fmap-y-or-n-p
  13596. Ask a series of boolean questions.
  13597. Takes args PROMPTER ACTOR LIST, and optional args HELP and ACTION-ALIST.
  13598.  
  13599. LIST is a list of objects, or a function of no arguments to return the next
  13600. object or nil.
  13601.  
  13602. If PROMPTER is a string, the prompt is (format PROMPTER OBJECT).  If not
  13603. a string, PROMPTER is a function of one arg (an object from LIST), which
  13604. returns a string to be used as the prompt for that object.  If the return
  13605. value is not a string, it may be nil to ignore the object or non-nil to act
  13606. on the object without asking the user.
  13607.  
  13608. ACTOR is a function of one arg (an object from LIST),
  13609. which gets called with each object that the user answers `yes' for.
  13610.  
  13611. If HELP is given, it is a list (OBJECT OBJECTS ACTION),
  13612. where OBJECT is a string giving the singular noun for an elt of LIST;
  13613. OBJECTS is the plural noun for elts of LIST, and ACTION is a transitive
  13614. verb describing ACTOR.  The default is ("object" "objects" "act on").
  13615.  
  13616. At the prompts, the user may enter y, Y, or SPC to act on that object;
  13617. n, N, or DEL to skip that object; ! to act on all following objects;
  13618. ESC or q to exit (skip all following objects); . (period) to act on the
  13619. current object and then exit; or \[help-command] to get help.
  13620.  
  13621. If ACTION-ALIST is given, it is an alist (KEY FUNCTION HELP) of extra keys
  13622. that will be accepted.  KEY is a character; FUNCTION is a function of one
  13623. arg (an object from LIST); HELP is a string.  When the user hits KEY,
  13624. FUNCTION is called.  If it returns non-nil, the object is considered
  13625. "acted upon", and the next object from LIST is processed.  If it returns
  13626. nil, the prompt is repeated for the same object.
  13627.  
  13628. Final optional argument NO-CURSOR-IN-ECHO-AREA non-nil says not to set
  13629. `cursor-in-echo-area' while prompting.
  13630.  
  13631. This function uses `query-replace-map' to define the standard responses,
  13632. but not all of the responses which `query-replace' understands
  13633. are meaningful here.
  13634.  
  13635. Returns the number of actions taken.Fforward-page
  13636. Move forward to page boundary.  With arg, repeat, or go back if negative.
  13637. A page boundary is any line whose beginning matches the regexp
  13638. `page-delimiter'.Fbackward-page
  13639. Move backward to page boundary.  With arg, repeat, or go fwd if negative.
  13640. A page boundary is any line whose beginning matches the regexp
  13641. `page-delimiter'.Fmark-page
  13642. Put mark at end of page, point at beginning.
  13643. A numeric arg specifies to move forward or backward by that many pages,
  13644. thus marking a page other than the one point was originally in.Fnarrow-to-page
  13645. Make text outside current page invisible.
  13646. A numeric arg specifies to move forward or backward by that many pages,
  13647. thus showing a page other than the one point was originally in.Fcount-lines-page
  13648. Report number of lines on current page, and how many are before or after point.Fwhat-page
  13649. Print page and line number of point.Vuse-hard-newlines
  13650. Non-nil means to distinguish hard and soft newlines.
  13651. When this is non-nil, the functions `newline' and `open-line' add the
  13652. text-property `hard' to newlines that they insert.  Also, a line is
  13653. only considered as a candidate to match `paragraph-start' or
  13654. `paragraph-separate' if it follows a hard newline.  Newlines not
  13655. marked hard are called "soft", and are always internal to
  13656. paragraphs.  The fill functions always insert soft newlines.
  13657.  
  13658. Each buffer has its own value of this variable.Vparagraph-start
  13659. *Regexp for beginning of a line that starts OR separates paragraphs.
  13660. This regexp should match lines that separate paragraphs
  13661. and should also match lines that start a paragraph
  13662. (and are part of that paragraph).
  13663.  
  13664. This is matched against the text at the left margin, which is not necessarily
  13665. the beginning of the line, so it should never use "^" as an anchor.  This
  13666. ensures that the paragraph functions will work equally well within a region
  13667. of text indented by a margin setting.
  13668.  
  13669. The variable `paragraph-separate' specifies how to distinguish
  13670. lines that start paragraphs from lines that separate them.
  13671.  
  13672. If the variable `use-hard-newlines' is nonnil, then only lines following a
  13673. hard newline are considered to match.Vparagraph-separate
  13674. *Regexp for beginning of a line that separates paragraphs.
  13675. If you change this, you may have to change paragraph-start also.
  13676.  
  13677. This is matched against the text at the left margin, which is not necessarily
  13678. the beginning of the line, so it should not use "^" as an anchor.  This
  13679. ensures that the paragraph functions will work equally within a region of
  13680. text indented by a margin setting.Vsentence-end
  13681. *Regexp describing the end of a sentence.
  13682. All paragraph boundaries also end sentences, regardless.
  13683.  
  13684. In order to be recognized as the end of a sentence, the ending period,
  13685. question mark, or exclamation point must be followed by two spaces,
  13686. unless it's inside some sort of quotes or parenthesis.Vpage-delimiter
  13687. *Regexp describing line-beginnings that separate pages.Vparagraph-ignore-fill-prefix
  13688. Non-nil means the paragraph commands are not affected by `fill-prefix'.
  13689. This is desirable in modes where blank lines are the paragraph delimiters.Fforward-paragraph
  13690. Move forward to end of paragraph.
  13691. With arg N, do it N times; negative arg -N means move backward N paragraphs.
  13692.  
  13693. A line which `paragraph-start' matches either separates paragraphs
  13694. (if `paragraph-separate' matches it also) or is the first line of a paragraph.
  13695. A paragraph end is the beginning of a line which is not part of the paragraph
  13696. to which the end of the previous line belongs, or the end of the buffer.Fbackward-paragraph
  13697. Move backward to start of paragraph.
  13698. With arg N, do it N times; negative arg -N means move forward N paragraphs.
  13699.  
  13700. A paragraph start is the beginning of a line which is a
  13701. `first-line-of-paragraph' or which is ordinary text and follows a
  13702. paragraph-separating line; except: if the first real line of a
  13703. paragraph is preceded by a blank line, the paragraph starts at that
  13704. blank line.
  13705.  
  13706. See `forward-paragraph' for more information.Fmark-paragraph
  13707. Put point at beginning of this paragraph, mark at end.
  13708. The paragraph marked is the one that contains point or follows point.Fkill-paragraph
  13709. Kill forward to end of paragraph.
  13710. With arg N, kill forward to Nth end of paragraph;
  13711. negative arg -N means kill backward to Nth start of paragraph.Fbackward-kill-paragraph
  13712. Kill back to start of paragraph.
  13713. With arg N, kill back to Nth start of paragraph;
  13714. negative arg -N means kill forward to Nth end of paragraph.Ftranspose-paragraphs
  13715. Interchange this (or next) paragraph with previous one.Fforward-sentence
  13716. Move forward to next `sentence-end'.  With argument, repeat.
  13717. With negative argument, move backward repeatedly to `sentence-beginning'.
  13718.  
  13719. The variable `sentence-end' is a regular expression that matches ends of
  13720. sentences.  Also, every paragraph boundary terminates sentences as well.Fbackward-sentence
  13721. Move backward to start of sentence.  With arg, do it arg times.
  13722. See `forward-sentence' for more information.Fkill-sentence
  13723. Kill from point to end of sentence.
  13724. With arg, repeat; negative arg -N means kill back to Nth start of sentence.Fbackward-kill-sentence
  13725. Kill back from point to start of sentence.
  13726. With arg, repeat, or kill forward to Nth end of sentence if negative arg -N.Fmark-end-of-sentence
  13727. Put mark at end of sentence.  Arg works as in `forward-sentence'.Ftranspose-sentences
  13728. Interchange this (next) and previous sentence.Vregister-alist
  13729. Alist of elements (NAME . CONTENTS), one for each Emacs register.
  13730. NAME is a character (a number).  CONTENTS is a string, number,
  13731. frame configuration, mark or list.
  13732. A list of strings represents a rectangle.
  13733. A list of the form (file . NAME) represents the file named NAME.Fget-register
  13734. Return contents of Emacs register named REG, or nil if none.Fset-register
  13735. Set contents of Emacs register named REGISTER to VALUE.  Returns VALUE.
  13736. See the documentation of the variable `register-alist' for possible VALUE.Fpoint-to-register
  13737. Store current location of point in register REGISTER.
  13738. With prefix argument, store current frame configuration.
  13739. Use \[jump-to-register] to go to that location or restore that configuration.
  13740. Argument is a character, naming the register.Fwindow-configuration-to-register
  13741. Store the window configuration of the selected frame in register REGISTER.
  13742. Use \[jump-to-register] to restore the configuration.
  13743. Argument is a character, naming the register.Fframe-configuration-to-register
  13744. Store the window configuration of all frames in register REGISTER.
  13745. Use \[jump-to-register] to restore the configuration.
  13746. Argument is a character, naming the register.Fjump-to-register
  13747. Move point to location stored in a register.
  13748. If the register contains a file name, find that file.
  13749.  (To put a file name in a register, you must use `set-register'.)
  13750. If the register contains a window configuration (one frame) or a frame
  13751. configuration (all frames), restore that frame or all frames accordingly.
  13752. First argument is a character, naming the register.
  13753. Optional second arg non-nil (interactively, prefix argument) says to
  13754. delete any existing frames that the frame configuration doesn't mention.
  13755. (Otherwise, these frames are iconified.)Fview-register
  13756. Display what is contained in register named REGISTER.
  13757. The Lisp value REGISTER is a character.Finsert-register
  13758. Insert contents of register REGISTER.  (REGISTER is a character.)
  13759. Normally puts point before and mark after the inserted text.
  13760. If optional second arg is non-nil, puts mark before and point after.
  13761. Interactively, second arg is non-nil if prefix arg is supplied.Fcopy-to-register
  13762. Copy region into register REGISTER.  With prefix arg, delete as well.
  13763. Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
  13764. START and END are buffer positions indicating what to copy.Fappend-to-register
  13765. Append region to text in register REGISTER.
  13766. With prefix arg, delete as well.
  13767. Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
  13768. START and END are buffer positions indicating what to append.Fprepend-to-register
  13769. Prepend region to text in register REGISTER.
  13770. With prefix arg, delete as well.
  13771. Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
  13772. START and END are buffer positions indicating what to prepend.Fcopy-rectangle-to-register
  13773. Copy rectangular region into register REGISTER.
  13774. With prefix arg, delete as well.
  13775. Called from program, takes four args: REGISTER, START, END and DELETE-FLAG.
  13776. START and END are buffer positions giving two corners of rectangle.Vcase-replace
  13777. *Non-nil means query-replace should preserve case in replacements.Vquery-replace-interactive
  13778. Non-nil means `query-replace' uses the last search string.
  13779. That becomes the "string to replace".Fquery-replace
  13780. Replace some occurrences of FROM-STRING with TO-STRING.
  13781. As each match is found, the user must type a character saying
  13782. what to do with it.  For directions, type \[help-command] at that time.
  13783.  
  13784. If `query-replace-interactive' is non-nil, the last incremental search
  13785. string is used as FROM-STRING--you don't have to specify it with the
  13786. minibuffer.
  13787.  
  13788. Preserves case in each replacement if `case-replace' and `case-fold-search'
  13789. are non-nil and FROM-STRING has no uppercase letters.
  13790. (Preserving case means that if the string matched is all caps, or capitalized,
  13791. then its replacement is upcased or capitalized.)
  13792.  
  13793. Third arg DELIMITED (prefix arg if interactive), if non-nil, means replace
  13794. only matches surrounded by word boundaries.
  13795.  
  13796. To customize possible responses, change the "bindings" in `query-replace-map'.Fquery-replace-regexp
  13797. Replace some things after point matching REGEXP with TO-STRING.
  13798. As each match is found, the user must type a character saying
  13799. what to do with it.  For directions, type \[help-command] at that time.
  13800.  
  13801. If `query-replace-interactive' is non-nil, the last incremental search
  13802. regexp is used as REGEXP--you don't have to specify it with the
  13803. minibuffer.
  13804.  
  13805. Preserves case in each replacement if `case-replace' and `case-fold-search'
  13806. are non-nil and REGEXP has no uppercase letters.
  13807. Third arg DELIMITED (prefix arg if interactive), if non-nil, means replace
  13808. only matches surrounded by word boundaries.
  13809. In TO-STRING, `\&' stands for whatever matched the whole of REGEXP,
  13810. and `\=\N' (where N is a digit) stands for
  13811.  whatever what matched the Nth `\(...\)' in REGEXP.Fmap-query-replace-regexp
  13812. Replace some matches for REGEXP with various strings, in rotation.
  13813. The second argument TO-STRINGS contains the replacement strings, separated
  13814. by spaces.  This command works like `query-replace-regexp' except
  13815. that each successive replacement uses the next successive replacement string,
  13816. wrapping around from the last such string to the first.
  13817.  
  13818. Non-interactively, TO-STRINGS may be a list of replacement strings.
  13819.  
  13820. If `query-replace-interactive' is non-nil, the last incremental search
  13821. regexp is used as REGEXP--you don't have to specify it with the minibuffer.
  13822.  
  13823. A prefix argument N says to use each replacement string N times
  13824. before rotating to the next.Freplace-string
  13825. Replace occurrences of FROM-STRING with TO-STRING.
  13826. Preserve case in each match if `case-replace' and `case-fold-search'
  13827. are non-nil and FROM-STRING has no uppercase letters.
  13828. (Preserving case means that if the string matched is all caps, or capitalized,
  13829. then its replacement is upcased or capitalized.)
  13830.  
  13831. Third arg DELIMITED (prefix arg if interactive), if non-nil, means replace
  13832. only matches surrounded by word boundaries.
  13833.  
  13834. If `query-replace-interactive' is non-nil, the last incremental search
  13835. string is used as FROM-STRING--you don't have to specify it with the
  13836. minibuffer.
  13837.  
  13838. This function is usually the wrong thing to use in a Lisp program.
  13839. What you probably want is a loop like this:
  13840.   (while (search-forward FROM-STRING nil t)
  13841.     (replace-match TO-STRING nil t))
  13842. which will run faster and will not set the mark or print anything.Freplace-regexp
  13843. Replace things after point matching REGEXP with TO-STRING.
  13844. Preserve case in each match if `case-replace' and `case-fold-search'
  13845. are non-nil and REGEXP has no uppercase letters.
  13846. Third arg DELIMITED (prefix arg if interactive), if non-nil, means replace
  13847. only matches surrounded by word boundaries.
  13848. In TO-STRING, `\&' stands for whatever matched the whole of REGEXP,
  13849. and `\=\N' (where N is a digit) stands for
  13850.  whatever what matched the Nth `\(...\)' in REGEXP.
  13851.  
  13852. If `query-replace-interactive' is non-nil, the last incremental search
  13853. regexp is used as REGEXP--you don't have to specify it with the minibuffer.
  13854.  
  13855. This function is usually the wrong thing to use in a Lisp program.
  13856. What you probably want is a loop like this:
  13857.   (while (re-search-forward REGEXP nil t)
  13858.     (replace-match TO-STRING nil nil))
  13859. which will run faster and will not set the mark or print anything.Vregexp-history
  13860. History list for some commands that read regular expressions.Fkeep-lines
  13861. Delete all lines except those containing matches for REGEXP.
  13862. A match split across lines preserves all the lines it lies in.
  13863. Applies to all lines after point.Fflush-lines
  13864. Delete lines containing matches for REGEXP.
  13865. If a match is split across lines, all the lines it lies in are deleted.
  13866. Applies to lines after point.Fhow-many
  13867. Print number of matches for REGEXP following point.Foccur-mode
  13868. Major mode for output from \[occur].
  13869. \<occur-mode-map>Move point to one of the items in this buffer, then use
  13870. \[occur-mode-goto-occurrence] to go to the occurrence that the item refers to.
  13871. Alternatively, click \[occur-mode-mouse-goto] on an item to go to it.
  13872.  
  13873. \{occur-mode-map}Foccur-mode-mouse-goto
  13874. In Occur mode, go to the occurrence whose line you click on.Foccur-mode-goto-occurrence
  13875. Go to the occurrence the current line describes.Vlist-matching-lines-default-context-lines
  13876. *Default number of context lines to include around a `list-matching-lines'
  13877. match.  A negative number means to include that many lines before the match.
  13878. A positive number means to include that many lines both before and after.Foccur
  13879. Show all lines in the current buffer containing a match for REGEXP.
  13880.  
  13881. If a match spreads across multiple lines, all those lines are shown.
  13882.  
  13883. Each line is displayed with NLINES lines before and after, or -NLINES
  13884. before if NLINES is negative.
  13885. NLINES defaults to `list-matching-lines-default-context-lines'.
  13886. Interactively it is the prefix arg.
  13887.  
  13888. The lines are shown in a buffer named `*Occur*'.
  13889. It serves as a menu to find any of the occurrences in this buffer.
  13890. \[describe-mode] in that buffer will explain how.Vquery-replace-help
  13891. Help message while in query-replaceVquery-replace-map
  13892. Keymap that defines the responses to questions in `query-replace'.
  13893. The "bindings" in this map are not commands; they are answers.
  13894. The valid answers include `act', `skip', `act-and-show',
  13895. `exit', `act-and-exit', `edit', `delete-and-edit', `recenter',
  13896. `automatic', `backup', `exit-prefix', and `help'.Fperform-replace
  13897. Subroutine of `query-replace'.  Its complexity handles interactive queries.
  13898. Don't use this in your own program unless you want to query and set the mark
  13899. just as `query-replace' does.  Instead, write a simple loop like this:
  13900.   (while (re-search-forward "foo[     ]+bar" nil t)
  13901.     (replace-match "foobar" nil nil))
  13902. which will run faster and probably do exactly what you want.Vquery-replace-highlight
  13903. *Non-nil means to highlight words during query replacement.Fnewline
  13904. Insert a newline, and move to left margin of the new line if it's blank.
  13905. The newline is marked with the text-property `hard'.
  13906. With arg, insert that many newlines.
  13907. In Auto Fill mode, if no numeric arg, break the preceding line if it's long.Fopen-line
  13908. Insert a newline and leave point before it.
  13909. If there is a fill prefix and/or a left-margin, insert them on the new line
  13910. if the line would have been blank.
  13911. With arg N, insert N newlines.Fsplit-line
  13912. Split current line, moving portion beyond point vertically down.Fquoted-insert
  13913. Read next input character and insert it.
  13914. This is useful for inserting control characters.
  13915. You may also type up to 3 octal digits, to insert a character with that code.
  13916.  
  13917. In overwrite mode, this function inserts the character anyway, and
  13918. does not handle octal digits specially.  This means that if you use
  13919. overwrite as your normal editing mode, you can use this function to
  13920. insert characters when necessary.
  13921.  
  13922. In binary overwrite mode, this function does overwrite, and octal
  13923. digits are interpreted as a character code.  This is supposed to make
  13924. this function useful in editing binary files.Fdelete-indentation
  13925. Join this line to previous and fix up whitespace at join.
  13926. If there is a fill prefix, delete it from the beginning of this line.
  13927. With argument, join this line to following line.Ffixup-whitespace
  13928. Fixup white space between objects around point.
  13929. Leave one space or none, according to the context.Fdelete-horizontal-space
  13930. Delete all spaces and tabs around point.Fjust-one-space
  13931. Delete all spaces and tabs around point, leaving one space.Fdelete-blank-lines
  13932. On blank line, delete all surrounding blank lines, leaving just one.
  13933. On isolated blank line, delete that one.
  13934. On nonblank line, delete any immediately following blank lines.Fback-to-indentation
  13935. Move point to the first non-whitespace character on this line.Fnewline-and-indent
  13936. Insert a newline, then indent according to major mode.
  13937. Indentation is done using the value of `indent-line-function'.
  13938. In programming language modes, this is the same as TAB.
  13939. In some text modes, where TAB inserts a tab, this command indents to the
  13940. column specified by the function `current-left-margin'.Freindent-then-newline-and-indent
  13941. Reindent current line, insert newline, then indent the new line.
  13942. Indentation of both lines is done according to the current major mode,
  13943. which means calling the current value of `indent-line-function'.
  13944. In programming language modes, this is the same as TAB.
  13945. In some text modes, where TAB inserts a tab, this indents to the
  13946. column specified by the function `current-left-margin'.Fbackward-delete-char-untabify
  13947. Delete characters backward, changing tabs into spaces.
  13948. Delete ARG chars, and kill (save in kill ring) if KILLP is non-nil.
  13949. Interactively, ARG is the prefix arg (default 1)
  13950. and KILLP is t if a prefix arg was specified.Fzap-to-char
  13951. Kill up to and including ARG'th occurrence of CHAR.
  13952. Goes backward if ARG is negative; error if CHAR not found.Fbeginning-of-buffer
  13953. Move point to the beginning of the buffer; leave mark at previous position.
  13954. With arg N, put point N/10 of the way from the beginning.
  13955.  
  13956. If the buffer is narrowed, this command uses the beginning and size
  13957. of the accessible part of the buffer.
  13958.  
  13959. Don't use this command in Lisp programs!
  13960. (goto-char (point-min)) is faster and avoids clobbering the mark.Fend-of-buffer
  13961. Move point to the end of the buffer; leave mark at previous position.
  13962. With arg N, put point N/10 of the way from the end.
  13963.  
  13964. If the buffer is narrowed, this command uses the beginning and size
  13965. of the accessible part of the buffer.
  13966.  
  13967. Don't use this command in Lisp programs!
  13968. (goto-char (point-max)) is faster and avoids clobbering the mark.Fmark-whole-buffer
  13969. Put point at beginning and mark at end of buffer.
  13970. You probably should not use this function in Lisp programs;
  13971. it is usually a mistake for a Lisp function to use any subroutine
  13972. that uses or sets the mark.Fcount-lines-region
  13973. Print number of lines and characters in the region.Fwhat-line
  13974. Print the current buffer line number and narrowed line number of point.Fcount-lines
  13975. Return number of lines between START and END.
  13976. This is usually the number of newlines between them,
  13977. but can be one more if START is not equal to END
  13978. and the greater of them is not at the start of a line.Fwhat-cursor-position
  13979. Print info on cursor position (on screen and within buffer).Ffundamental-mode
  13980. Major mode not specialized for anything in particular.
  13981. Other major modes are defined by comparison with this one.Vread-expression-map
  13982. Minibuffer keymap used for reading Lisp expressions.Feval-expression
  13983. Evaluate EXPRESSION and print value in minibuffer.
  13984. Value is also consed on to front of the variable `values'.Fedit-and-eval-command
  13985. Prompting with PROMPT, let user edit COMMAND and eval result.
  13986. COMMAND is a Lisp expression.  Let user edit that expression in
  13987. the minibuffer, then read and evaluate the result.Frepeat-complex-command
  13988. Edit and re-evaluate last complex command, or ARGth from last.
  13989. A complex command is one which used the minibuffer.
  13990. The command is placed in the minibuffer as a Lisp form for editing.
  13991. The result is executed, repeating the command as changed.
  13992. If the command has been changed or is not the most recent previous command
  13993. it is added to the front of the command history.
  13994. You can use the minibuffer history commands \<minibuffer-local-map>\[next-history-element] and \[previous-history-element]
  13995. to get different commands to edit and resubmit.Vminibuffer-history
  13996. Default minibuffer history list.
  13997. This is used for all minibuffer input
  13998. except when an alternate history list is specified.Vminibuffer-history-sexp-flag
  13999. Non-nil when doing history operations on `command-history'.
  14000. More generally, indicates that the history list being acted on
  14001. contains expressions rather than strings.Fprevious-matching-history-element
  14002. Find the previous history element that matches REGEXP.
  14003. (Previous history elements refer to earlier actions.)
  14004. With prefix argument N, search for Nth previous match.
  14005. If N is negative, find the next or Nth next match.Fnext-matching-history-element
  14006. Find the next history element that matches REGEXP.
  14007. (The next history element refers to a more recent action.)
  14008. With prefix argument N, search for Nth next match.
  14009. If N is negative, find the previous or Nth previous match.Fnext-history-element
  14010. Insert the next element of the minibuffer history into the minibuffer.Fprevious-history-element
  14011. Inserts the previous element of the minibuffer history into the minibuffer.Fnext-complete-history-element
  14012. Get next element of history which is a completion of minibuffer contents.Fprevious-complete-history-element
  14013. Get previous element of history which is a completion of minibuffer contents.Fgoto-line
  14014. Goto line ARG, counting from line 1 at beginning of buffer.Fundo
  14015. Undo some previous changes.
  14016. Repeat this command to undo more changes.
  14017. A numeric argument serves as a repeat count.Vpending-undo-list
  14018. Within a run of consecutive undo commands, list remaining to be undone.Fundo-start
  14019. Set `pending-undo-list' to the front of the undo list.
  14020. The next call to `undo-more' will undo the most recently made change.Fundo-more
  14021. Undo back N undo-boundaries beyond what was already undone recently.
  14022. Call `undo-start' to get ready to undo recent changes,
  14023. then call `undo-more' one or more times to undo them.Vshell-command-history
  14024. History list for some commands that read shell commands.Vshell-command-switch
  14025. Switch used to have the shell execute its command line argument.Fshell-command
  14026. Execute string COMMAND in inferior shell; display output, if any.
  14027.  
  14028. If COMMAND ends in ampersand, execute it asynchronously.
  14029. The output appears in the buffer `*Async Shell Command*'.
  14030. That buffer is in shell mode.
  14031.  
  14032. Otherwise, COMMAND is executed synchronously.  The output appears in the
  14033. buffer `*Shell Command Output*'.
  14034. If the output is one line, it is displayed in the echo area *as well*,
  14035. but it is nonetheless available in buffer `*Shell Command Output*',
  14036. even though that buffer is not automatically displayed.
  14037. If there is no output, or if output is inserted in the current buffer,
  14038. then `*Shell Command Output*' is deleted.
  14039.  
  14040. The optional second argument OUTPUT-BUFFER, if non-nil,
  14041. says to put the output in some other buffer.
  14042. If OUTPUT-BUFFER is a buffer or buffer name, put the output there.
  14043. If OUTPUT-BUFFER is not a buffer and not nil,
  14044. insert output in current buffer.  (This cannot be done asynchronously.)
  14045. In either case, the output is inserted after point (leaving mark after it).Fshell-command-on-region
  14046. Execute string COMMAND in inferior shell with region as input.
  14047. Normally display output (if any) in temp buffer `*Shell Command Output*';
  14048. Prefix arg means replace the region with it.
  14049.  
  14050. The noninteractive arguments are START, END, COMMAND, OUTPUT-BUFFER, REPLACE.
  14051. If REPLACE is non-nil, that means insert the output
  14052. in place of text from START to END, putting point and mark around it.
  14053.  
  14054. If the output is one line, it is displayed in the echo area,
  14055. but it is nonetheless available in buffer `*Shell Command Output*'
  14056. even though that buffer is not automatically displayed.
  14057. If there is no output, or if output is inserted in the current buffer,
  14058. then `*Shell Command Output*' is deleted.
  14059.  
  14060. If the optional fourth argument OUTPUT-BUFFER is non-nil,
  14061. that says to put the output in some other buffer.
  14062. If OUTPUT-BUFFER is a buffer or buffer name, put the output there.
  14063. If OUTPUT-BUFFER is not a buffer and not nil,
  14064. insert output in the current buffer.
  14065. In either case, the output is inserted after point (leaving mark after it).Vuniversal-argument-map
  14066. Keymap used while processing \[universal-argument].Vuniversal-argument-num-events
  14067. Number of argument-specifying events read by `universal-argument'.
  14068. `universal-argument-other-key' uses this to discard those events
  14069. from (this-command-keys), and reread only the final command.Funiversal-argument
  14070. Begin a numeric argument for the following command.
  14071. Digits or minus sign following \[universal-argument] make up the numeric argument.
  14072. \[universal-argument] following the digits or minus sign ends the argument.
  14073. \[universal-argument] without digits or minus sign provides 4 as argument.
  14074. Repeating \[universal-argument] without digits or minus sign
  14075.  multiplies the argument by 4 each time.Fnegative-argument
  14076. Begin a negative numeric argument for the next command.
  14077. \[universal-argument] following digits or minus sign ends the argument.Fdigit-argument
  14078. Part of the numeric argument for the next command.
  14079. \[universal-argument] following digits or minus sign ends the argument.Fforward-to-indentation
  14080. Move forward ARG lines and position at first nonblank character.Fbackward-to-indentation
  14081. Move backward ARG lines and position at first nonblank character.Vkill-whole-line
  14082. *If non-nil, `kill-line' with no arg at beg of line kills the whole line.Fkill-line
  14083. Kill the rest of the current line; if no nonblanks there, kill thru newline.
  14084. With prefix argument, kill that many lines from point.
  14085. Negative arguments kill lines backward.
  14086.  
  14087. When calling from a program, nil means "no arg",
  14088. a number counts as a prefix arg.
  14089.  
  14090. If `kill-whole-line' is non-nil, then kill the whole line
  14091. when given no argument at the beginning of a line.Vinterprogram-cut-function
  14092. Function to call to make a killed region available to other programs.
  14093.  
  14094. Most window systems provide some sort of facility for cutting and
  14095. pasting text between the windows of different programs.
  14096. This variable holds a function that Emacs calls whenever text
  14097. is put in the kill ring, to make the new kill available to other
  14098. programs.
  14099.  
  14100. The function takes one or two arguments.
  14101. The first argument, TEXT, is a string containing
  14102. the text which should be made available.
  14103. The second, PUSH, if non-nil means this is a "new" kill;
  14104. nil means appending to an "old" kill.Vinterprogram-paste-function
  14105. Function to call to get text cut from other programs.
  14106.  
  14107. Most window systems provide some sort of facility for cutting and
  14108. pasting text between the windows of different programs.
  14109. This variable holds a function that Emacs calls to obtain
  14110. text that other programs have provided for pasting.
  14111.  
  14112. The function should be called with no arguments.  If the function
  14113. returns nil, then no other program has provided such text, and the top
  14114. of the Emacs kill ring should be used.  If the function returns a
  14115. string, that string should be put in the kill ring as the latest kill.
  14116.  
  14117. Note that the function should return a string only if a program other
  14118. than Emacs has provided a string for pasting; if Emacs provided the
  14119. most recent string, the function should return nil.  If it is
  14120. difficult to tell whether Emacs or some other program provided the
  14121. current string, it is probably good enough to return nil if the string
  14122. is equal (according to `string=') to the last text Emacs provided.Vkill-ring
  14123. List of killed text sequences.
  14124. Since the kill ring is supposed to interact nicely with cut-and-paste
  14125. facilities offered by window systems, use of this variable should
  14126. interact nicely with `interprogram-cut-function' and
  14127. `interprogram-paste-function'.  The functions `kill-new',
  14128. `kill-append', and `current-kill' are supposed to implement this
  14129. interaction; you may want to use them instead of manipulating the kill
  14130. ring directly.Vkill-ring-max
  14131. *Maximum length of kill ring before oldest elements are thrown away.Vkill-ring-yank-pointer
  14132. The tail of the kill ring whose car is the last thing yanked.Fkill-new
  14133. Make STRING the latest kill in the kill ring.
  14134. Set the kill-ring-yank pointer to point to it.
  14135. If `interprogram-cut-function' is non-nil, apply it to STRING.
  14136. Optional second argument REPLACE non-nil means that STRING will replace
  14137. the front of the kill ring, rather than being added to the list.Fkill-append
  14138. Append STRING to the end of the latest kill in the kill ring.
  14139. If BEFORE-P is non-nil, prepend STRING to the kill.
  14140. If `interprogram-cut-function' is set, pass the resulting kill to
  14141. it.Fcurrent-kill
  14142. Rotate the yanking point by N places, and then return that kill.
  14143. If N is zero, `interprogram-paste-function' is set, and calling it
  14144. returns a string, then that string is added to the front of the
  14145. kill ring and returned as the latest kill.
  14146. If optional arg DO-NOT-MOVE is non-nil, then don't actually move the 
  14147. yanking point; just return the Nth kill forward.Vkill-read-only-ok
  14148. *Non-nil means don't signal an error for killing read-only text.Fkill-region
  14149. Kill between point and mark.
  14150. The text is deleted but saved in the kill ring.
  14151. The command \[yank] can retrieve it from there.
  14152. (If you want to kill and then yank immediately, use \[copy-region-as-kill].)
  14153. If the buffer is read-only, Emacs will beep and refrain from deleting
  14154. the text, but put the text in the kill ring anyway.  This means that
  14155. you can use the killing commands to copy text from a read-only buffer.
  14156.  
  14157. This is the primitive for programs to kill text (as opposed to deleting it).
  14158. Supply two arguments, character numbers indicating the stretch of text
  14159.  to be killed.
  14160. Any command that calls this function is a "kill command".
  14161. If the previous command was also a kill command,
  14162. the text killed this time appends to the text killed last time
  14163. to make one entry in the kill ring.Fcopy-region-as-kill
  14164. Save the region as if killed, but don't kill it.
  14165. If `interprogram-cut-function' is non-nil, also save the text for a window
  14166. system cut and paste.Fkill-ring-save
  14167. Save the region as if killed, but don't kill it.
  14168. This command is similar to `copy-region-as-kill', except that it gives
  14169. visual feedback indicating the extent of the region being copied.
  14170. If `interprogram-cut-function' is non-nil, also save the text for a window
  14171. system cut and paste.Fappend-next-kill
  14172. Cause following command, if it kills, to append to previous kill.Fyank-pop
  14173. Replace just-yanked stretch of killed text with a different stretch.
  14174. This command is allowed only immediately after a `yank' or a `yank-pop'.
  14175. At such a time, the region contains a stretch of reinserted
  14176. previously-killed text.  `yank-pop' deletes that text and inserts in its
  14177. place a different stretch of killed text.
  14178.  
  14179. With no argument, the previous kill is inserted.
  14180. With argument N, insert the Nth previous kill.
  14181. If N is negative, this is a more recent kill.
  14182.  
  14183. The sequence of kills wraps around, so that after the oldest one
  14184. comes the newest one.Fyank
  14185. Reinsert the last stretch of killed text.
  14186. More precisely, reinsert the stretch of killed text most recently
  14187. killed OR yanked.  Put point at end, and set mark at beginning.
  14188. With just C-u as argument, same but put point at beginning (and mark at end).
  14189. With argument N, reinsert the Nth most recently killed stretch of killed
  14190. text.
  14191. See also the command \[yank-pop].Frotate-yank-pointer
  14192. Rotate the yanking point in the kill ring.
  14193. With argument, rotate that many kills forward (or backward, if negative).Finsert-buffer
  14194. Insert after point the contents of BUFFER.
  14195. Puts mark after the inserted text.
  14196. BUFFER may be a buffer or a buffer name.Fappend-to-buffer
  14197. Append to specified buffer the text of the region.
  14198. It is inserted into that buffer before its point.
  14199.  
  14200. When calling from a program, give three arguments:
  14201. BUFFER (or buffer name), START and END.
  14202. START and END specify the portion of the current buffer to be copied.Fprepend-to-buffer
  14203. Prepend to specified buffer the text of the region.
  14204. It is inserted into that buffer after its point.
  14205.  
  14206. When calling from a program, give three arguments:
  14207. BUFFER (or buffer name), START and END.
  14208. START and END specify the portion of the current buffer to be copied.Fcopy-to-buffer
  14209. Copy to specified buffer the text of the region.
  14210. It is inserted into that buffer, replacing existing text there.
  14211.  
  14212. When calling from a program, give three arguments:
  14213. BUFFER (or buffer name), START and END.
  14214. START and END specify the portion of the current buffer to be copied.Fmark
  14215. Return this buffer's mark value as integer; error if mark inactive.
  14216. If optional argument FORCE is non-nil, access the mark value
  14217. even if the mark is not currently active, and return nil
  14218. if there is no mark at all.
  14219.  
  14220. If you are using this in an editing command, you are most likely making
  14221. a mistake; see the documentation of `set-mark'.Fdeactivate-mark
  14222. Deactivate the mark by setting `mark-active' to nil.
  14223. (That makes a difference only in Transient Mark mode.)
  14224. Also runs the hook `deactivate-mark-hook'.Fset-mark
  14225. Set this buffer's mark to POS.  Don't use this function!
  14226. That is to say, don't use this function unless you want
  14227. the user to see that the mark has moved, and you want the previous
  14228. mark position to be lost.
  14229.  
  14230. Normally, when a new mark is set, the old one should go on the stack.
  14231. This is why most applications should use push-mark, not set-mark.
  14232.  
  14233. Novice Emacs Lisp programmers often try to use the mark for the wrong
  14234. purposes.  The mark saves a location for the user's convenience.
  14235. Most editing commands should not alter the mark.
  14236. To remember a location for internal use in the Lisp program,
  14237. store it in a Lisp variable.  Example:
  14238.  
  14239.    (let ((beg (point))) (forward-line 1) (delete-region beg (point))).Vmark-ring
  14240. The list of former marks of the current buffer, most recent first.Vmark-ring-max
  14241. *Maximum size of mark ring.  Start discarding off end if gets this big.Vglobal-mark-ring
  14242. The list of saved global marks, most recent first.Vglobal-mark-ring-max
  14243. *Maximum size of global mark ring.  Start discarding off end if gets this big.Fset-mark-command
  14244. Set mark at where point is, or jump to mark.
  14245. With no prefix argument, set mark, push old mark position on local mark
  14246. ring, and push mark on global mark ring.
  14247. With argument, jump to mark, and pop a new position for mark off the ring
  14248. (does not affect global mark ring).
  14249.  
  14250. Novice Emacs Lisp programmers often try to use the mark for the wrong
  14251. purposes.  See the documentation of `set-mark' for more information.Fpush-mark
  14252. Set mark at LOCATION (point, by default) and push old mark on mark ring.
  14253. If the last global mark pushed was not in the current buffer,
  14254. also push LOCATION on the global mark ring.
  14255. Display `Mark set' unless the optional second arg NOMSG is non-nil.
  14256. In Transient Mark mode, activate mark if optional third arg ACTIVATE non-nil.
  14257.  
  14258. Novice Emacs Lisp programmers often try to use the mark for the wrong
  14259. purposes.  See the documentation of `set-mark' for more information.
  14260.  
  14261. In Transient Mark mode, this does not activate the mark.Fpop-mark
  14262. Pop off mark ring into the buffer's actual mark.
  14263. Does not set point.  Does nothing if mark ring is empty.Fexchange-point-and-mark
  14264. Put the mark where point is now, and point where the mark is now.
  14265. This command works even when the mark is not active,
  14266. and it reactivates the mark.Ftransient-mark-mode
  14267. Toggle Transient Mark mode.
  14268. With arg, turn Transient Mark mode on if arg is positive, off otherwise.
  14269.  
  14270. In Transient Mark mode, when the mark is active, the region is highlighted.
  14271. Changing the buffer "deactivates" the mark.
  14272. So do certain other operations that set the mark
  14273. but whose main purpose is something else--for example,
  14274. incremental search, \[beginning-of-buffer], and \[end-of-buffer].Fpop-global-mark
  14275. Pop off global mark ring and jump to the top location.Vnext-line-add-newlines
  14276. *If non-nil, `next-line' inserts newline to avoid `end of buffer' error.Fnext-line
  14277. Move cursor vertically down ARG lines.
  14278. If there is no character in the target line exactly under the current column,
  14279. the cursor is positioned after the character in that line which spans this
  14280. column, or at the end of the line if it is not long enough.
  14281. If there is no line in the buffer after this one, behavior depends on the
  14282. value of `next-line-add-newlines'.  If non-nil, it inserts a newline character
  14283. to create a line, and moves the cursor to that line.  Otherwise it moves the
  14284. cursor to the end of the buffer.
  14285.  
  14286. The command \[set-goal-column] can be used to create
  14287. a semipermanent goal column to which this command always moves.
  14288. Then it does not try to move vertically.  This goal column is stored
  14289. in `goal-column', which is nil when there is none.
  14290.  
  14291. If you are thinking of using this in a Lisp program, consider
  14292. using `forward-line' instead.  It is usually easier to use
  14293. and more reliable (no dependence on goal column, etc.).Fprevious-line
  14294. Move cursor vertically up ARG lines.
  14295. If there is no character in the target line exactly over the current column,
  14296. the cursor is positioned after the character in that line which spans this
  14297. column, or at the end of the line if it is not long enough.
  14298.  
  14299. The command \[set-goal-column] can be used to create
  14300. a semipermanent goal column to which this command always moves.
  14301. Then it does not try to move vertically.
  14302.  
  14303. If you are thinking of using this in a Lisp program, consider using
  14304. `forward-line' with a negative argument instead.  It is usually easier
  14305. to use and more reliable (no dependence on goal column, etc.).Vtrack-eol
  14306. *Non-nil means vertical motion starting at end of line keeps to ends of lines.
  14307. This means moving to the end of each line moved onto.
  14308. The beginning of a blank line does not count as the end of a line.Vgoal-column
  14309. *Semipermanent goal column for vertical motion, as set by \[set-goal-column], or nil.Vtemporary-goal-column
  14310. Current goal column for vertical motion.
  14311. It is the column where point was
  14312. at the start of current run of vertical motion commands.
  14313. When the `track-eol' feature is doing its job, the value is 9999.Vline-move-ignore-invisible
  14314. *Non-nil means \[next-line] and \[previous-line] ignore invisible lines.
  14315. Outline mode sets this.Fset-goal-column
  14316. Set the current horizontal position as a goal for \[next-line] and \[previous-line].
  14317. Those commands will move to this position in the line moved to
  14318. rather than trying to keep the same horizontal position.
  14319. With a non-nil argument, clears out the goal column
  14320. so that \[next-line] and \[previous-line] resume vertical motion.
  14321. The goal column is stored in the variable `goal-column'.Vhscroll-step
  14322. *The number of columns to try scrolling a window by when point moves out.
  14323. If that fails to bring point back on frame, point is centered instead.
  14324. If this is zero, point is always centered after it moves off frame.Fhscroll-point-visible
  14325. Scrolls the selected window horizontally to make point visible.Fscroll-other-window-down
  14326. Scroll the "other window" down.
  14327. For more details, see the documentation for `scroll-other-window'.Fbeginning-of-buffer-other-window
  14328. Move point to the beginning of the buffer in the other window.
  14329. Leave mark at previous position.
  14330. With arg N, put point N/10 of the way from the true beginning.Fend-of-buffer-other-window
  14331. Move point to the end of the buffer in the other window.
  14332. Leave mark at previous position.
  14333. With arg N, put point N/10 of the way from the true end.Ftranspose-chars
  14334. Interchange characters around point, moving forward one character.
  14335. With prefix arg ARG, effect is to take character before point
  14336. and drag it forward past ARG other characters (backward if ARG negative).
  14337. If no argument and at end of line, the previous two chars are exchanged.Ftranspose-words
  14338. Interchange words around point, leaving point at end of them.
  14339. With prefix arg ARG, effect is to take word before or around point
  14340. and drag it forward past ARG other words (backward if ARG negative).
  14341. If ARG is zero, the words around or after point and around or after mark
  14342. are interchanged.Ftranspose-sexps
  14343. Like \[transpose-words] but applies to sexps.
  14344. Does not work on a sexp that point is in the middle of
  14345. if it is a list or string.Ftranspose-lines
  14346. Exchange current line and previous line, leaving point after both.
  14347. With argument ARG, takes previous line and moves it past ARG lines.
  14348. With argument 0, interchanges line point is in with line mark is in.Vcomment-column
  14349. *Column to indent right-margin comments to.
  14350. Setting this variable automatically makes it local to the current buffer.
  14351. Each mode establishes a different default value for this variable; you
  14352. can set the value for a particular mode using that mode's hook.Vcomment-start
  14353. *String to insert to start a new comment, or nil if no comment syntax.Vcomment-start-skip
  14354. *Regexp to match the start of a comment plus everything up to its body.
  14355. If there are any \(...\) pairs, the comment delimiter text is held to begin
  14356. at the place matched by the close of the first pair.Vcomment-end
  14357. *String to insert to end a new comment.
  14358. Should be an empty string if comments are terminated by end-of-line.Vcomment-indent-hook
  14359. Obsolete variable for function to compute desired indentation for a comment.
  14360. This function is called with no args with point at the beginning of
  14361. the comment's starting delimiter.Vcomment-indent-function
  14362. Function to compute desired indentation for a comment.
  14363. This function is called with no args with point at the beginning of
  14364. the comment's starting delimiter.Vblock-comment-start
  14365. *String to insert to start a new comment on a line by itself.
  14366. If nil, use `comment-start' instead.
  14367. Note that the regular expression `comment-start-skip' should skip this string
  14368. as well as the `comment-start' string.Vblock-comment-end
  14369. *String to insert to end a new comment on a line by itself.
  14370. Should be an empty string if comments are terminated by end-of-line.
  14371. If nil, use `comment-end' instead.Findent-for-comment
  14372. Indent this line's comment to comment column, or insert an empty comment.Fset-comment-column
  14373. Set the comment column based on point.
  14374. With no arg, set the comment column to the current column.
  14375. With just minus as arg, kill any comment on this line.
  14376. With any other arg, set comment column to indentation of the previous comment
  14377.  and then align or create a comment on this line at that column.Fkill-comment
  14378. Kill the comment on this line, if any.
  14379. With argument, kill comments on that many lines starting with this one.Fcomment-region
  14380. Comment or uncomment each line in the region.
  14381. With just C-u prefix arg, uncomment each line in region.
  14382. Numeric prefix arg ARG means use ARG comment characters.
  14383. If ARG is negative, delete that many comment characters instead.
  14384. Comments are terminated on each line, even for syntax in which newline does
  14385. not end the comment.  Blank lines do not get comments.Fbackward-word
  14386. Move backward until encountering the end of a word.
  14387. With argument, do this that many times.
  14388. In programs, it is faster to call `forward-word' with negative arg.Fmark-word
  14389. Set mark arg words away from point.Fkill-word
  14390. Kill characters forward until encountering the end of a word.
  14391. With argument, do this that many times.Fbackward-kill-word
  14392. Kill characters backward until encountering the end of a word.
  14393. With argument, do this that many times.Fcurrent-word
  14394. Return the word point is on (or a nearby word) as a string.
  14395. If optional arg STRICT is non-nil, return nil unless point is within
  14396. or adjacent to a word.Vfill-prefix
  14397. *String for filling to insert at front of new line, or nil for none.
  14398. Setting this variable automatically makes it local to the current buffer.Vauto-fill-inhibit-regexp
  14399. *Regexp to match lines which should not be auto-filled.Vnormal-auto-fill-function
  14400. The function to use for `auto-fill-function' if Auto Fill mode is turned on.
  14401. Some major modes set this.Fauto-fill-mode
  14402. Toggle Auto Fill mode.
  14403. With arg, turn Auto Fill mode on if and only if arg is positive.
  14404. In Auto Fill mode, inserting a space at a column beyond `current-fill-column'
  14405. automatically breaks the line at a previous space.
  14406.  
  14407. The value of `normal-auto-fill-function' specifies the function to use
  14408. for `auto-fill-function' when turning Auto Fill mode on.Fauto-fill-function
  14409. Automatically break line at a previous space, in insertion of text.Fturn-on-auto-fill
  14410. Unconditionally turn on Auto Fill mode.Fset-fill-column
  14411. Set `fill-column' to specified argument.
  14412. Just \[universal-argument] as argument means to use the current column.Vcomment-multi-line
  14413. *Non-nil means \[indent-new-comment-line] should continue same comment
  14414. on new line, with no new terminator or starter.
  14415. This is obsolete because you might as well use \[newline-and-indent].Findent-new-comment-line
  14416. Break line at point and indent, continuing comment if within one.
  14417. This indents the body of the continued comment
  14418. under the previous comment line.
  14419.  
  14420. This command is intended for styles where you write a comment per line,
  14421. starting a new comment (and terminating it if necessary) on each line.
  14422. If you want to continue one comment across several lines, use \[newline-and-indent].
  14423.  
  14424. If a fill column is specified, it overrides the use of the comment column
  14425. or comment indentation.
  14426.  
  14427. The inserted newline is marked hard if `use-hard-newlines' is true, 
  14428. unless optional argument SOFT is non-nil.Fset-selective-display
  14429. Set `selective-display' to ARG; clear it if no arg.
  14430. When the value of `selective-display' is a number > 0,
  14431. lines whose indentation is >= that value are not displayed.
  14432. The variable `selective-display' has a separate value for each buffer.Voverwrite-mode-textual
  14433. The string displayed in the mode line when in overwrite mode.Voverwrite-mode-binary
  14434. The string displayed in the mode line when in binary overwrite mode.Foverwrite-mode
  14435. Toggle overwrite mode.
  14436. With arg, turn overwrite mode on iff arg is positive.
  14437. In overwrite mode, printing characters typed in replace existing text
  14438. on a one-for-one basis, rather than pushing it to the right.  At the
  14439. end of a line, such characters extend the line.  Before a tab,
  14440. such characters insert until the tab is filled in.
  14441. \[quoted-insert] still inserts characters in overwrite mode; this
  14442. is supposed to make it easier to insert characters when necessary.Fbinary-overwrite-mode
  14443. Toggle binary overwrite mode.
  14444. With arg, turn binary overwrite mode on iff arg is positive.
  14445. In binary overwrite mode, printing characters typed in replace
  14446. existing text.  Newlines are not treated specially, so typing at the
  14447. end of a line joins the line to the next, with the typed character
  14448. between them.  Typing before a tab character simply replaces the tab
  14449. with the character typed.
  14450. \[quoted-insert] replaces the text at the cursor, just as ordinary
  14451. typing characters do.
  14452.  
  14453. Note that binary overwrite mode is not its own minor mode; it is a
  14454. specialization of overwrite-mode, entered by setting the
  14455. `overwrite-mode' variable to `overwrite-mode-binary'.Vline-number-mode
  14456. *Non-nil means display line number in mode line.Fline-number-mode
  14457. Toggle Line Number mode.
  14458. With arg, turn Line Number mode on iff arg is positive.
  14459. When Line Number mode is enabled, the line number appears
  14460. in the mode line.Vcolumn-number-mode
  14461. *Non-nil means display column number in mode line.Fcolumn-number-mode
  14462. Toggle Column Number mode.
  14463. With arg, turn Column Number mode on iff arg is positive.
  14464. When Column Number mode is enabled, the column number appears
  14465. in the mode line.Vblink-matching-paren
  14466. *Non-nil means show matching open-paren when close-paren is inserted.Vblink-matching-paren-on-screen
  14467. *Non-nil means show matching open-paren when it is on screen.
  14468. nil means don't show it (but the open-paren can still be shown
  14469. when it is off screen.Vblink-matching-paren-distance
  14470. *If non-nil, is maximum distance to search for matching open-paren.Vblink-matching-delay
  14471. *The number of seconds that `blink-matching-open' will delay at a match.Vblink-matching-paren-dont-ignore-comments
  14472. *Non-nil means `blink-matching-paren' should not ignore comments.Fblink-matching-open
  14473. Move cursor momentarily to the beginning of the sexp before point.Fkeyboard-quit
  14474. Signal a  quit  condition.
  14475. During execution of Lisp code, this character causes a quit directly.
  14476. At top-level, as an editor command, this simply beeps.Vbuffer-quit-function
  14477. Function to call to "quit" the current buffer, or nil if none.
  14478. \[keyboard-escape-quit] calls this function when its more local actions
  14479. (such as cancelling a prefix argument, minibuffer or region) do not apply.Fkeyboard-escape-quit
  14480. Exit the current "mode" (in a generalized sense of the word).
  14481. This command can exit an interactive command such as `query-replace',
  14482. can clear out a prefix argument or a region,
  14483. can get out of the minibuffer or other recursive edit,
  14484. cancel the use of the current buffer (for special-purpose buffers),
  14485. or go back to just one window (by deleting all but the selected window).Fset-variable
  14486. Set VARIABLE to VALUE.  VALUE is a Lisp object.
  14487. When using this interactively, supply a Lisp expression for VALUE.
  14488. If you want VALUE to be a string, you must surround it with doublequotes.
  14489.  
  14490. If VARIABLE has a `variable-interactive' property, that is used as if
  14491. it were the arg to `interactive' (which see) to interactively read the value.Vcompletion-list-mode-map
  14492. Local map for completion list buffers.Vcompletion-reference-buffer
  14493. Record the buffer that was current when the completion list was requested.
  14494. This is a local variable in the completion list buffer.
  14495. Initial value is nil to avoid some compiler warnings.Vcompletion-base-size
  14496. Number of chars at beginning of minibuffer not involved in completion.
  14497. This is a local variable in the completion list buffer
  14498. but it talks about the buffer in `completion-reference-buffer'.
  14499. If this is nil, it means to compare text to determine which part
  14500. of the tail end of the buffer's text is involved in completion.Fdelete-completion-window
  14501. Delete the completion list window.
  14502. Go to the window from which completion was requested.Fprevious-completion
  14503. Move to the previous item in the completion list.Fnext-completion
  14504. Move to the next item in the completion list.
  14505. With prefix argument N, move N items (negative N means move backward).Fchoose-completion
  14506. Choose the completion that point is in or next to.Fcompletion-list-mode
  14507. Major mode for buffers showing lists of possible completions.
  14508. Type \<completion-list-mode-map>\[choose-completion] in the completion list to select the completion near point.
  14509. Use \<completion-list-mode-map>\[mouse-choose-completion] to select one with the mouse.Vcompletion-fixup-function
  14510. A function to customize how completions are identified in completion lists.
  14511. `completion-setup-function' calls this function with no arguments
  14512. each time it has found what it thinks is one completion.
  14513. Point is at the end of the completion in the completion list buffer.
  14514. If this function moves point, it can alter the end of that completion.Fswitch-to-completions
  14515. Select the completion list window.Fevent-apply-modifier
  14516. Apply a modifier flag to event EVENT.
  14517. SYMBOL is the name of this modifier, as a symbol.
  14518. LSHIFTBY is the numeric value of this modifier, in keyboard events.
  14519. PREFIX is the string that represents this modifier in an event type symbol.Vcommand-line-processed
  14520. t once command line has been processedVinhibit-startup-message
  14521. *Non-nil inhibits the initial startup message.
  14522. This is for use in your personal init file, once you are familiar
  14523. with the contents of the startup message.Vinhibit-startup-echo-area-message
  14524. *Non-nil inhibits the initial startup echo area message.
  14525. Inhibition takes effect only if your `.emacs' file contains
  14526. a line of this form:
  14527.  (setq inhibit-startup-echo-area-message "YOUR-USER-NAME")
  14528. If your `.emacs' file is byte-compiled, use the following form instead:
  14529.  (eval '(setq inhibit-startup-echo-area-message "YOUR-USER-NAME"))
  14530. Thus, someone else using a copy of your `.emacs' file will see
  14531. the startup message unless he personally acts to inhibit it.Vinhibit-default-init
  14532. *Non-nil inhibits loading the `default' library.Vcommand-switch-alist
  14533. Alist of command-line switches.
  14534. Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
  14535. HANDLER-FUNCTION receives switch name as sole arg;
  14536. remaining command-line args are in the variable `command-line-args-left'.Vcommand-line-args-left
  14537. List of command-line args not yet processed.Vcommand-line-functions
  14538. List of functions to process unrecognized command-line arguments.
  14539. Each function should access the dynamically bound variables
  14540. `argi' (the current argument) and `command-line-args-left' (the remaining
  14541. arguments).  The function should return non-nil only if it recognizes and
  14542. processes `argi'.  If it does so, it may consume successive arguments by
  14543. altering `command-line-args-left' to remove them.Vcommand-line-default-directory
  14544. Default directory to use for command line arguments.
  14545. This is normally copied from `default-directory' when Emacs starts.Vcommand-line-x-option-alist
  14546. Alist of X Windows options.
  14547. Each element has the form
  14548.   (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
  14549. where NAME is the option name string, NUMARGS is the number of arguments
  14550. that the option accepts, HANDLER is a function to call to handle the option.
  14551. FRAME-PARAM (optional) is the frame parameter this option specifies,
  14552. and VALUE is the value which is given to that frame parameter
  14553. (most options use the argument for this, so VALUE is not present).Vbefore-init-hook
  14554. Normal hook run after handling urgent options but before loading init files.Vafter-init-hook
  14555. Normal hook run after loading the init files, `~/.emacs' and `default.el'.
  14556. There is no `condition-case' around the running of these functions;
  14557. therefore, if you set `debug-on-error' non-nil in `.emacs',
  14558. an error in one of these functions will invoke the debugger.Vemacs-startup-hook
  14559. Normal hook run after loading init files and handling the command line.Vterm-setup-hook
  14560. Normal hook run after loading terminal-specific Lisp code.
  14561. It also follows `emacs-startup-hook'.  This hook exists for users to set,
  14562. so as to override the definitions made by the terminal-specific file.
  14563. Emacs never sets this variable itself.Vkeyboard-type
  14564. The brand of keyboard you are using.
  14565. This variable is used to define
  14566. the proper function and keypad keys for use under X.  It is used in a
  14567. fashion analogous to the environment value TERM.Vwindow-setup-hook
  14568. Normal hook run to initialize window system display.
  14569. Emacs runs this hook after processing the command line arguments and loading
  14570. the user's init file.Vinitial-major-mode
  14571. Major mode command symbol to use for the initial *scratch* buffer.Vinit-file-user
  14572. Identity of user whose `.emacs' file is or was read.
  14573. The value is nil if no init file is being used; otherwise, it may be either
  14574. the null string, meaning that the init file was taken from the user that
  14575. originally logged in, or it may be a string containing a user's name.
  14576.  
  14577. In either of the latter cases, `(concat "~" init-file-user "/")'
  14578. evaluates to the name of the directory where the `.emacs' file was
  14579. looked for.
  14580.  
  14581. Setting `init-file-user' does not prevent Emacs from loading
  14582. `site-start.el'.  The only way to do that is to use `--no-site-file'.Vsite-run-file
  14583. File containing site-wide run-time initializations.
  14584. This file is loaded at run-time before `~/.emacs'.  It contains inits
  14585. that need to be in place for the entire site, but which, due to their
  14586. higher incidence of change, don't make sense to load into emacs'
  14587. dumped image.  Thus, the run-time load order is: 1. file described in
  14588. this variable, if non-nil; 2. `~/.emacs'; 3. `default.el'.
  14589.  
  14590. Don't use the `site-start.el' file for things some users may not like.
  14591. Put them in `default.el' instead, so that users can more easily
  14592. override them.  Users can prevent loading `default.el' with the `-q'
  14593. option or by setting `inhibit-default-init' in their own init files,
  14594. but inhibiting `site-start.el' requires `--no-site-file', which
  14595. is less convenient.Viso-8859-1-locale-regexp
  14596. Regexp that specifies when to enable the ISO 8859-1 character set.
  14597. We do that if this regexp matches the locale name
  14598. specified by the LC_ALL, LC_CTYPE and LANG environment variables.Vmail-host-address
  14599. *Name of this machine, for purposes of naming users.Vuser-mail-address
  14600. *Full mailing address of this user.
  14601. This is initialized based on `mail-host-address',
  14602. after your init file is read, in case it sets `mail-host-address'.Vauto-save-list-file-prefix
  14603. Prefix for generating `auto-save-list-file-name'.
  14604. This is used after reading your `.emacs' file to initialize
  14605. `auto-save-list-file-name', by appending Emacs's pid and the system name,
  14606. if you have not already set `auto-save-list-file-name' yourself.
  14607. Set this to nil if you want to prevent `auto-save-list-file-name'
  14608. from being initialized.Fcommand-line-normalize-file-name
  14609. Collapse multiple slashes to one, to handle non-Emacs file names.Flambda
  14610. Return a lambda expression.
  14611. A call of the form (lambda ARGS DOCSTRING INTERACTIVE BODY) is
  14612. self-quoting; the result of evaluating the lambda expression is the
  14613. expression itself.  The lambda expression may then be treated as a
  14614. function, i.e., stored as the function value of a symbol, passed to
  14615. funcall or mapcar, etc.
  14616.  
  14617. ARGS should take the same form as an argument list for a `defun'.
  14618. DOCSTRING is an optional documentation string.
  14619.  If present, it should describe how to call the function.
  14620.  But documentation strings are usually not useful in nameless functions.
  14621. INTERACTIVE should be a call to the function `interactive', which see.
  14622. It may also be omitted.
  14623. BODY should be a list of lisp expressions.Fsuppress-keymap
  14624. Make MAP override all normally self-inserting keys to be undefined.
  14625. Normally, as an exception, digits and minus-sign are set to make prefix args,
  14626. but optional second arg NODIGITS non-nil treats them like other chars.Vkey-substitution-in-progress
  14627. Used internally by substitute-key-definition.Fsubstitute-key-definition
  14628. Replace OLDDEF with NEWDEF for any keys in KEYMAP now defined as OLDDEF.
  14629. In other words, OLDDEF is replaced with NEWDEF where ever it appears.
  14630. If optional fourth argument OLDMAP is specified, we redefine
  14631. in KEYMAP as NEWDEF those chars which are defined as OLDDEF in OLDMAP.Fdefine-key-after
  14632. Add binding in KEYMAP for KEY => DEFINITION, right after AFTER's binding.
  14633. This is like `define-key' except that the binding for KEY is placed
  14634. just after the binding for the event AFTER, instead of at the beginning
  14635. of the map.
  14636. The order matters when the keymap is used as a menu.
  14637. KEY must contain just one event type--that is to say, it must be
  14638. a string or vector of length 1.Fkeyboard-translate
  14639. Translate character FROM to TO at a low level.
  14640. This function creates a `keyboard-translate-table' if necessary
  14641. and then modifies one entry in it.Vglobal-map
  14642. Default global keymap mapping Emacs keyboard input into commands.
  14643. The value is a keymap which is usually (but not necessarily) Emacs's
  14644. global map.Vesc-map
  14645. Default keymap for ESC (meta) commands.
  14646. The normal global definition of the character ESC indirects to this keymap.Vctl-x-map
  14647. Default keymap for C-x commands.
  14648. The normal global definition of the character C-x indirects to this keymap.Vctl-x-4-map
  14649. Keymap for subcommands of C-x 4Vctl-x-5-map
  14650. Keymap for frame commands.Flistify-key-sequence
  14651. Convert a key sequence to a list of events.Feventp
  14652. True if the argument is an event object.Fevent-modifiers
  14653. Returns a list of symbols representing the modifier keys in event EVENT.
  14654. The elements of the list may include `meta', `control',
  14655. `shift', `hyper', `super', `alt', `click', `double', `triple', `drag',
  14656. and `down'.Fevent-basic-type
  14657. Returns the basic type of the given event (all modifiers removed).
  14658. The value is an ASCII printing character (not upper case) or a symbol.Fmouse-movement-p
  14659. Return non-nil if OBJECT is a mouse movement event.Fevent-start
  14660. Return the starting position of EVENT.
  14661. If EVENT is a mouse press or a mouse click, this returns the location
  14662. of the event.
  14663. If EVENT is a drag, this returns the drag's starting position.
  14664. The return value is of the form
  14665.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14666. The `posn-' functions access elements of such lists.Fevent-end
  14667. Return the ending location of EVENT.  EVENT should be a click or drag event.
  14668. If EVENT is a click event, this function is the same as `event-start'.
  14669. The return value is of the form
  14670.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14671. The `posn-' functions access elements of such lists.Fevent-click-count
  14672. Return the multi-click count of EVENT, a click or drag event.
  14673. The return value is a positive integer.Fposn-window
  14674. Return the window in POSITION.
  14675. POSITION should be a list of the form
  14676.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14677. as returned by the `event-start' and `event-end' functions.Fposn-point
  14678. Return the buffer location in POSITION.
  14679. POSITION should be a list of the form
  14680.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14681. as returned by the `event-start' and `event-end' functions.Fposn-x-y
  14682. Return the x and y coordinates in POSITION.
  14683. POSITION should be a list of the form
  14684.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14685. as returned by the `event-start' and `event-end' functions.Fposn-col-row
  14686. Return the column and row in POSITION, measured in characters.
  14687. POSITION should be a list of the form
  14688.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14689. as returned by the `event-start' and `event-end' functions.
  14690. For a scroll-bar event, the result column is 0, and the row
  14691. corresponds to the vertical position of the click in the scroll bar.Fposn-timestamp
  14692. Return the timestamp of POSITION.
  14693. POSITION should be a list of the form
  14694.    (WINDOW BUFFER-POSITION (X . Y) TIMESTAMP)
  14695. as returned by the `event-start' and `event-end' functions.Fbaud-rate
  14696. Obsolete function returning the value of the `baud-rate' variable.
  14697. Please convert your programs to use the variable `baud-rate' directly.Vrun-hooks
  14698. Variable by which C primitives find the function `run-hooks'.
  14699. Don't change it.  Don't use it either; use the hook running C primitives.Fmake-local-hook
  14700. Make the hook HOOK local to the current buffer.
  14701. When a hook is local, its local and global values
  14702. work in concert: running the hook actually runs all the hook
  14703. functions listed in *either* the local value *or* the global value
  14704. of the hook variable.
  14705.  
  14706. This function works by making `t' a member of the buffer-local value,
  14707. which acts as a flag to run the hook functions in the default value as
  14708. well.  This works for all normal hooks, but does not work for most
  14709. non-normal hooks yet.  We will be changing the callers of non-normal
  14710. hooks so that they can handle localness; this has to be done one by
  14711. one.
  14712.  
  14713. This function does nothing if HOOK is already local in the current
  14714. buffer.
  14715.  
  14716. Do not use `make-local-variable' to make a hook variable buffer-local.Fadd-hook
  14717. Add to the value of HOOK the function FUNCTION.
  14718. FUNCTION is not added if already present.
  14719. FUNCTION is added (if necessary) at the beginning of the hook list
  14720. unless the optional argument APPEND is non-nil, in which case
  14721. FUNCTION is added at the end.
  14722.  
  14723. The optional fourth argument, LOCAL, if non-nil, says to modify
  14724. the hook's buffer-local value rather than its default value.
  14725. This makes no difference if the hook is not buffer-local.
  14726. To make a hook variable buffer-local, always use
  14727. `make-local-hook', not `make-local-variable'.
  14728.  
  14729. HOOK should be a symbol, and FUNCTION may be any valid function.  If
  14730. HOOK is void, it is first set to nil.  If HOOK's value is a single
  14731. function, it is changed to a list of functions.Fremove-hook
  14732. Remove from the value of HOOK the function FUNCTION.
  14733. HOOK should be a symbol, and FUNCTION may be any valid function.  If
  14734. FUNCTION isn't the value of HOOK, or, if FUNCTION doesn't appear in the
  14735. list of hooks to run in HOOK, then nothing is done.  See `add-hook'.
  14736.  
  14737. The optional third argument, LOCAL, if non-nil, says to modify
  14738. the hook's buffer-local value rather than its default value.
  14739. This makes no difference if the hook is not buffer-local.
  14740. To make a hook variable buffer-local, always use
  14741. `make-local-hook', not `make-local-variable'.Fadd-to-list
  14742. Add to the value of LIST-VAR the element ELEMENT if it isn't there yet.
  14743. The test for presence of ELEMENT is done with `equal'.
  14744. If you want to use `add-to-list' on a variable that is not defined
  14745. until a certain package is loaded, you should put the call to `add-to-list'
  14746. into a hook function that will be run only after loading the package.
  14747. `eval-after-load' provides one way to do this.  In some cases
  14748. other hooks, such as major mode hooks, can do the job.Feval-after-load
  14749. Arrange that, if FILE is ever loaded, FORM will be run at that time.
  14750. This makes or adds to an entry on `after-load-alist'.
  14751. If FILE is already loaded, evaluate FORM right now.
  14752. It does nothing if FORM is already on the list for FILE.
  14753. FILE should be the name of a library, with no directory name.Feval-next-after-load
  14754. Read the following input sexp, and run it whenever FILE is loaded.
  14755. This makes or adds to an entry on `after-load-alist'.
  14756. FILE should be the name of a library, with no directory name.Fread-quoted-char
  14757. Like `read-char', except that if the first character read is an octal
  14758. digit, we read up to two more octal digits and return the character
  14759. represented by the octal number consisting of those digits.
  14760. Optional argument PROMPT specifies a string to use to prompt the user.Fforce-mode-line-update
  14761. Force the mode-line of the current buffer to be redisplayed.
  14762. With optional non-nil ALL, force redisplay of all mode-lines.Fmomentary-string-display
  14763. Momentarily display STRING in the buffer at POS.
  14764. Display remains until next character is typed.
  14765. If the char is EXIT-CHAR (optional third arg, default is SPC) it is swallowed;
  14766. otherwise it is then available as input (as a command if nothing else).
  14767. Display MESSAGE (optional fourth arg) in the echo area.
  14768. If MESSAGE is nil, instructions to type EXIT-CHAR are displayed there.Vbuffer-file-type
  14769. Non-nil if the visited file is a binary file.
  14770. This variable is meaningful on MS-DOG and Windows NT.
  14771. On those systems, it is automatically local in every buffer.
  14772. On other systems, this variable is normally always nil.Fget-buffer-window-list
  14773. Return windows currently displaying BUFFER, or nil if none.
  14774. See `walk-windows' for the meaning of MINIBUF and FRAME.Fignore
  14775. Do nothing and return nil.
  14776. This function accepts any number of arguments, but ignores them.Ferror
  14777. Signal an error, making error message by passing all args to `format'.
  14778. In Emacs, the convention is that error messages start with a capital
  14779. letter but *do not* end with a period.  Please follow this convention
  14780. for the sake of consistency.Fstart-process-shell-command
  14781. Start a program in a subprocess.  Return the process object for it.
  14782. Args are NAME BUFFER COMMAND &rest COMMAND-ARGS.
  14783. NAME is name for process.  It is modified if necessary to make it unique.
  14784. BUFFER is the buffer or (buffer-name) to associate with the process.
  14785.  Process output goes at end of that buffer, unless you specify
  14786.  an output stream or filter function to handle the output.
  14787.  BUFFER may be also nil, meaning that this process is not associated
  14788.  with any buffer
  14789. Third arg is command name, the name of a shell command.
  14790. Remaining arguments are the arguments for the command.
  14791. Wildcards and redirection are handled as usual in the shell.Fsave-match-data
  14792. Execute the BODY forms, restoring the global value of the match data.Fmatch-string
  14793. Return string of text matched by last search.
  14794. NUM specifies which parenthesized expression in the last regexp.
  14795.  Value is nil if NUMth pair didn't match, or there were less than NUM pairs.
  14796. Zero means the entire text matched by the whole regexp or whole string.
  14797. STRING should be given if the last search was by `string-match' on STRING.Fshell-quote-argument
  14798. Quote an argument for passing as argument to an inferior shell.Fmake-syntax-table
  14799. Return a new syntax table.
  14800. It inherits all letters and control characters from the standard
  14801. syntax table; other characters are copied from the standard syntax table.Fglobal-set-key
  14802. Give KEY a global binding as COMMAND.
  14803. COMMAND is a symbol naming an interactively-callable function.
  14804. KEY is a key sequence (a string or vector of characters or event types).
  14805. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  14806. can be included if you use a vector.
  14807. Note that if KEY has a local binding in the current buffer
  14808. that local binding will continue to shadow any global binding.Flocal-set-key
  14809. Give KEY a local binding as COMMAND.
  14810. COMMAND is a symbol naming an interactively-callable function.
  14811. KEY is a key sequence (a string or vector of characters or event types).
  14812. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  14813. can be included if you use a vector.
  14814. The binding goes in the current buffer's local map,
  14815. which in most cases is shared with all other buffers in the same major mode.Fglobal-unset-key
  14816. Remove global binding of KEY.
  14817. KEY is a string representing a sequence of keystrokes.Flocal-unset-key
  14818. Remove local binding of KEY.
  14819. KEY is a string representing a sequence of keystrokes.Fframe-configuration-p
  14820. Return non-nil if OBJECT seems to be a frame configuration.
  14821. Any list whose car is `frame-configuration' is assumed to be a frame
  14822. configuration.Vtext-mode-syntax-table
  14823. Syntax table used while in text mode.Vtext-mode-abbrev-table
  14824. Abbrev table used while in text mode.Vtext-mode-map
  14825. Keymap for Text mode.
  14826. Many other modes, such as Mail mode, Outline mode and Indented Text mode,
  14827. inherit all the commands defined in this map.Ftext-mode
  14828. Major mode for editing text intended for humans to read.
  14829. Special commands:
  14830. \{text-mode-map}
  14831. Turning on Text mode calls the value of the variable `text-mode-hook',
  14832. if that value is non-nil.Vindented-text-mode-map
  14833. Keymap for Indented Text mode.
  14834. All the commands defined in Text mode are inherited unless overridden.Findented-text-mode
  14835. Major mode for editing text with indented paragraphs.
  14836. In this mode, paragraphs are delimited only by blank lines.
  14837. You can thus get the benefit of adaptive filling
  14838.  (see the variable `adaptive-fill-mode').
  14839. \{indented-text-mode-map}
  14840. Turning on `indented-text-mode' calls the value of the variable
  14841. `text-mode-hook', if that value is non-nil.Fcenter-paragraph
  14842. Center each nonblank line in the paragraph at or after point.
  14843. See `center-line' for more info.Fcenter-region
  14844. Center each nonblank line starting in the region.
  14845. See `center-line' for more info.Fcenter-line
  14846. Center the line point is on, within the width specified by `fill-column'.
  14847. This means adjusting the indentation so that it equals
  14848. the distance between the end of the text and `fill-column'.
  14849. The argument NLINES says how many lines to center.Vvc-default-back-end
  14850. *Back-end actually used by this interface; may be SCCS or RCS.
  14851. The value is only computed when needed to avoid an expensive search.Vvc-handle-cvs
  14852. *If non-nil, use VC for files managed with CVS.
  14853. If it is nil, don't use VC for those files.Vvc-rcsdiff-knows-brief
  14854. *Indicates whether rcsdiff understands the --brief option.
  14855. The value is either `yes', `no', or nil.  If it is nil, VC tries
  14856. to use --brief and sets this variable to remember whether it worked.Vvc-path
  14857. *List of extra directories to search for version control commands.Vvc-master-templates
  14858. *Where to look for version-control master files.
  14859. The first pair corresponding to a given back end is used as a template
  14860. when creating new masters.Vvc-make-backup-files
  14861. *If non-nil, backups of registered files are made as with other files.
  14862. If nil (the default), files covered by version control don't get backups.Vvc-follow-symlinks
  14863. *Indicates what to do if you visit a symbolic link to a file
  14864. that is under version control.  Editing such a file through the
  14865. link bypasses the version control system, which is dangerous and
  14866. probably not what you want.  
  14867.   If this variable is t, VC follows the link and visits the real file,
  14868. telling you about it in the echo area.  If it is `ask', VC asks for
  14869. confirmation whether it should follow the link.  If nil, the link is
  14870. visited and a warning displayed.Vvc-display-status
  14871. *If non-nil, display revision number and lock status in modeline.
  14872. Otherwise, not displayed.Vvc-consult-headers
  14873. *If non-nil, identify work files by searching for version headers.Vvc-keep-workfiles
  14874. *If non-nil, don't delete working files after registering changes.
  14875. If the back-end is CVS, workfiles are always kept, regardless of the
  14876. value of this flag.Vvc-mistrust-permissions
  14877. *If non-nil, don't assume that permissions and ownership track 
  14878. version-control status.  If nil, do rely on the permissions.
  14879. See also variable `vc-consult-headers'.Vvc-file-prop-obarray
  14880. Obarray for per-file properties.Fvc-name
  14881. Return the master name of a file, nil if it is not registered.
  14882. For CVS, the full name of CVS/Entries is returned.Fvc-backend
  14883. Return the version-control type of a file, nil if it is not registered.Fvc-buffer-backend
  14884. Return the version-control type of the visited file, or nil if none.Fvc-toggle-read-only
  14885. Change read-only status of current buffer, perhaps via version control.
  14886. If the buffer is visiting a file registered with version control,
  14887. then check the file in or out.  Otherwise, just change the read-only flag
  14888. of the buffer.  With prefix argument, ask for version number.Fvc-mode-line
  14889. Set `vc-mode' to display type of version control for FILE.
  14890. The value is set in the current buffer, which should be the buffer
  14891. visiting FILE.  Second optional arg LABEL is put in place of version
  14892. control system name.Fvc-file-not-found-hook
  14893. When file is not found, try to check it out from RCS or SCCS.
  14894. Returns t if checkout was successful, nil otherwise.Fone-window-p
  14895. Returns non-nil if the selected window is the only window (in its frame).
  14896. Optional arg NOMINI non-nil means don't count the minibuffer
  14897. even if it is active.
  14898.  
  14899. The optional arg ALL-FRAMES t means count windows on all frames.
  14900. If it is `visible', count windows on all visible frames.
  14901. ALL-FRAMES nil or omitted means count only the selected frame, 
  14902. plus the minibuffer it uses (which may be on another frame).
  14903. If ALL-FRAMES is neither nil nor t, count only the selected frame.Fwalk-windows
  14904. Cycle through all visible windows, calling PROC for each one.
  14905. PROC is called with a window as argument.
  14906.  
  14907. Optional second arg MINIBUF t means count the minibuffer window even
  14908. if not active.  MINIBUF nil or omitted means count the minibuffer iff
  14909. it is active.  MINIBUF neither t nor nil means not to count the
  14910. minibuffer even if it is active.
  14911.  
  14912. Several frames may share a single minibuffer; if the minibuffer
  14913. counts, all windows on all frames that share that minibuffer count
  14914. too.  Therefore, if you are using a separate minibuffer frame
  14915. and the minibuffer is active and MINIBUF says it counts,
  14916. `walk-windows' includes the windows in the frame from which you
  14917. entered the minibuffer, as well as the minibuffer window.
  14918.  
  14919. ALL-FRAMES is the optional third argument.
  14920. ALL-FRAMES nil or omitted means cycle within the frames as specified above.
  14921. ALL-FRAMES = `visible' means include windows on all visible frames.
  14922. ALL-FRAMES = 0 means include windows on all visible and iconified frames.
  14923. ALL-FRAMES = t means include windows on all frames including invisible frames.
  14924. Anything else means restrict to the selected frame.Fminibuffer-window-active-p
  14925. Return t if WINDOW (a minibuffer window) is now active.Fsave-selected-window
  14926. Execute BODY, then select the window that was selected before BODY.Fcount-windows
  14927. Returns the number of visible windows.
  14928. Optional arg MINIBUF non-nil means count the minibuffer
  14929. even if it is inactive.Fbalance-windows
  14930. Makes all visible windows the same height (approximately).Vsplit-window-keep-point
  14931. *If non-nil, split windows keeps the original point in both children.
  14932. This is often more convenient for editing.
  14933. If nil, adjust point in each of the two windows to minimize redisplay.
  14934. This is convenient on slow terminals, but point can move strangely.Fsplit-window-vertically
  14935. Split current window into two windows, one above the other.
  14936. The uppermost window gets ARG lines and the other gets the rest.
  14937. Negative arg means select the size of the lowermost window instead.
  14938. With no argument, split equally or close to it.
  14939. Both windows display the same buffer now current.
  14940.  
  14941. If the variable split-window-keep-point is non-nil, both new windows
  14942. will get the same value of point as the current window.  This is often
  14943. more convenient for editing.
  14944.  
  14945. Otherwise, we chose window starts so as to minimize the amount of
  14946. redisplay; this is convenient on slow terminals.  The new selected
  14947. window is the one that the current value of point appears in.  The
  14948. value of point can change if the text around point is hidden by the
  14949. new mode line.Fsplit-window-horizontally
  14950. Split current window into two windows side by side.
  14951. This window becomes the leftmost of the two, and gets ARG columns.
  14952. Negative arg means select the size of the rightmost window instead.
  14953. No arg means split equally.Fenlarge-window-horizontally
  14954. Make current window ARG columns wider.Fshrink-window-horizontally
  14955. Make current window ARG columns narrower.Fshrink-window-if-larger-than-buffer
  14956. Shrink the WINDOW to be as small as possible to display its contents.
  14957. Do not shrink to less than `window-min-height' lines.
  14958. Do nothing if the buffer contains more lines than the present window height,
  14959. or if some of the window's contents are scrolled out of view,
  14960. or if the window is not the full width of the frame,
  14961. or if the window is the only window of its frame.Vemacs-version
  14962. Version numbers of this version of Emacs.Vemacs-build-time
  14963. Time at which Emacs was dumped out.Femacs-version
  14964. Return string describing the version of Emacs that is running.
  14965. If optional argument HERE is non-nil, insert string at point.
  14966. Don't use this function in programs to choose actions according
  14967. to the system configuration; look at `system-configuration' instead.